本文介绍Ant Design Vue Cascader API属性及事件列表的浏览器版,如果你是基于Node.js进行开发请点击这里查看。
<a-cascader :options="options" @change="onChange" placeholder="请选择城市" ></a-cascader>
:符号表示属性变量,@符号表示事件
参数名称 | 说明 | 类型 | 默认值 |
---|---|---|---|
allow-clear | 是否支持清除已选择内容 <a-cascader :allow-clear="false"></a-cascader> | boolean | true |
auto-focus | 当前控件是否自动获取焦点,示例代码如上 <a-cascader :auto-focus="true"></a-cascader> | boolean | false |
change-on-select | 设置为true,就是每次点击选择时都会触发change事件 <a-cascader :change-on-select="true"></a-cascader> | boolean | false |
default-value | 默认的选中项 <a-cascader :default-value="['shanghai','qingpuqu']" ></a-cascader> | string[] | number[] | [] |
disabled | 是否禁用 | boolean | false |
display-render | 选择完成后执行的渲染函数,可以自定义选择框的内容 | 点击查看例子 | |
expand-trigger | 下一级级菜单的展开方式,点击或移动在上面时 'click' 和 'hover' | string | click |
field-names | 自定义下拉项的数据结构中的label name children 的字段 | 点击查看例子 | { label: 'label', value: 'value', children: 'children' } |
getPopupContainer | 组件渲染的父节点。默认渲染到 body 上,如遇到菜单滚动定位问题,可修改为滚动的区域试试看,并相对其定位。 | Function(triggerNode) | () => document.body |
loadData | 可以通过这个参数发送一个ajax请求,远程返回数据, 不能与 showSearch 搭配使用。 | 点击查看详情 | |
not-found-content | 当下拉项为空时显示的内容 | string | 'Not Found' |
options | 下拉项数据源 | object | |
placeholder | 选择输入框提示文字 | string | '请选择' |
popup-class-name | 自定义下拉项的浮层类名 <a-cascader popup-class-name="itxst-class" ></a-cascader> | string | - |
popup-style | 自定义下拉项的浮层样式 <a-cascader :popup-style="{color:'red'}"></a-cascader> | object | {} |
popup-placement | 浮层预设位置:bottomLeft bottomRight topLeft topRight | Enum | bottomLeft |
popup-visible | 下拉项的浮层的隐藏显示 | boolean | |
show-search | 在选择输入框中开启搜索功能,点击查看详情 | boolean | false |
size | 选择输入框大小,可选 large default small,注意不是下拉浮层的大小 | string | default |
suffixIcon | 自定义的选择输入框的后缀图标 | string | VNode | slot | - |
value(v-model) | 设置获取选中项 | string[] | number[] | - |
事件名称 | 说明 | 回调参数 |
---|---|---|
change | 选择完成后的回调 | (value, selectedOptions) => void |
popupVisibleChange | 显示/隐藏浮层的回调 | (value) => void |
方法名称 | 说明 |
---|---|
blur() | 清除焦点 |
focus() | 设置焦点 |