Cascader 多级联动

规则

{
    type:"cascader",
    title:"所在区域",
    field:"address",
    value:['陕西省','西安市','新城区'],
    props:{
        options:[{
            value: 'beijing',
            label: '北京',
            children: [
                {
                    value: 'gugong',
                    label: '故宫'
                },
                {
                    value: 'tiantan',
                    label: '天坛'
                },
                {
                    value: 'wangfujing',
                    label: '王府井'
                }
            ]
        }, {
            value: 'jiangsu',
            label: '江苏',
            children: [
                {
                    value: 'nanjing',
                    label: '南京',
                    children: [
                        {
                            value: 'fuzimiao',
                            label: '夫子庙',
                        }
                    ]
                },
                {
                    value: 'suzhou',
                    label: '苏州',
                    children: [
                        {
                            value: 'zhuozhengyuan',
                            label: '拙政园',
                        },
                        {
                            value: 'shizilin',
                            label: '狮子林',
                        }
                    ]
                }
            ]
        }]
    }
}

参考:Ant-design-vue_Cascader

value :Array

Props

参数	说明	类型	默认值
allowClear	是否支持清除	boolean	true
autofocus	自动获取焦点	boolean	false
bordered	是否有边框	boolean	true
clearIcon	自定义的选择框清空图标	slot	-
changeOnSelect	（单选时生效）当此项为 true 时，点选每级菜单选项值都会发生变化，具体见上面的演示	boolean	false
defaultValue	默认的选中项	string[] \| number[]	[]
disabled	禁用	boolean	false
displayRender	选择后展示的渲染函数,可使用 #displayRender="{labels, selectedOptions}"	`({labels, selectedOptions}) => VNode`	`labels => labels.join(' / ')`
popupClassName	自定义浮层类名	string	-
dropdownStyle	自定义浮层样式	CSSProperties	{}
expandIcon	自定义次级菜单展开图标	slot	-
expandTrigger	次级菜单的展开方式	`click`	`hover`
fieldNames	自定义 options 中 `label` `value` `children` 的字段	object	`{ label: 'label', value: 'value', children: 'children' }`
getPopupContainer	菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。	Function(triggerNode)	() => document.body
loadData	用于动态加载选项，无法与 `showSearch` 一起使用	`(selectedOptions) => void`	-
maxTagCount	最多显示多少个 tag，响应式模式会对性能产生损耗	number \| `responsive`	-
maxTagPlaceholder	隐藏 tag 时显示的内容	v-slot \| function(omittedValues)	-
multiple	支持多选节点	boolean	-
notFoundContent	当下拉列表为空时显示的内容	string \| slot	'Not Found'
open	控制浮层显隐	boolean	-
options	可选项数据源	Option[]	-
placeholder	输入框占位文本	string	'请选择'
placement	浮层预设位置	`bottomLeft`	`bottomRight`
showCheckedStrategy	定义选中项回填的方式。`Cascader.SHOW_CHILD`: 只显示选中的子节点。`Cascader.SHOW_PARENT`: 只显示父节点（当父节点下所有子节点都选中时）。	`Cascader.SHOW_PARENT`	`Cascader.SHOW_CHILD`
removeIcon	自定义的多选框清除图标	slot	-
searchValue	设置搜索的值，需要与 `showSearch` 配合使用	string	-
showSearch	在选择框中显示搜索框	boolean \| object	false
status	设置校验状态	'error' \| 'warning'	-
size	输入框大小	`large`	`default`
suffixIcon	自定义的选择框后缀图标	string \| VNode \| slot	-
tagRender	自定义 tag 内容，多选时生效	slot	-

showSearch 为对象时，其中的字段：

参数	说明	类型	默认值
filter	接收 `inputValue` `path` 两个参数，当 `path` 符合筛选条件时，应返回 true，反之则返回 false。	`function(inputValue, path): boolean`
limit	搜索结果展示数量	number \| false	50
matchInputWidth	搜索结果列表是否与输入框同宽	boolean
render	用于渲染 filter 后的选项,可使用 #showSearchRender="{inputValue, path}"	`function({inputValue, path}): VNode`
sort	用于排序 filter 后的选项	`function(a, b, inputValue)`

Events

事件名称	说明	回调参数
change	选择完成后的回调	`(value, selectedOptions) => void`
dropdownVisibleChange	显示/隐藏浮层的回调	`(value) => void`
search	监听搜索，返回输入的值	`(value) => void`

Option

interface Option {
  value: string | number;
  label?: any;
  disabled?: boolean;
  children?: Option[];
  // 标记是否为叶子节点，设置了 `loadData` 时有效
  // 设为 `false` 时会强制标记为父节点，即使当前节点没有 children，也会显示展开图标
  isLeaf?: boolean;
}

Cascader 多级联动 ​

规则 ​

Props ​

Events ​

Option ​

Cascader 多级联动

规则

Props

Events

Option