Skip to content

Cascader 级联选择器

规则

基础示例

Props 配置示例

可搜索

任意一级可选(changeOnSelect)

整段禁用

尺寸对比(小 / 中 / 大)

Events 事件示例

参考:Antdv Next Cascader

valuestring[] | number[]

Props

参数说明类型默认值版本
allowClear支持清除boolean |true-
changeOnSelect单选时生效(multiple 下始终可选),点选每级菜单选项值都会发生变化booleanfalse-
classes用于自定义组件内部各语义化结构的 classRecord<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string>--
disabled禁用booleanfalse-
expandTrigger次级菜单展开方式click | hoverclick-
fieldNames自定义 options 中 label / value / childrenobject{ label, value, children }-
getPopupContainer菜单渲染父节点(triggerNode) => HTMLElement() => document.body-
loadData动态加载选项,无法与 showSearch 一起使用(selectedOptions) => void--
maxTagCount最多显示多少个 tagnumber | responsive--
maxTagPlaceholder隐藏 tag 时显示的内容VueNode | function(omittedValues)--
maxTagTextLength最大显示的 tag 文本长度number--
multiple支持多选节点boolean--
open控制浮层显隐boolean--
options可选项数据源Option[]--
placeholder输入框占位文本string--
placement浮层预设位置bottomLeft | bottomRight | topLeft | topRightbottomLeft-
popupMenuColumnStyle下拉菜单列的样式CSSProperties--
showCheckedStrategy选中项回填方式(multiple 为 true 时)Cascader.SHOW_PARENT | Cascader.SHOW_CHILDCascader.SHOW_PARENT-
showSearch在选择框中显示搜索框boolean | Objectfalse-
size输入框大小large | middle | small--
status设置校验状态error | warning--
styles用于自定义内部语义化结构的 styleRecord<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties>--
value指定选中项,支持 v-model:valuestring[] | number[]--
variant形态变体outlined | borderless | filled | underlinedoutlined-

Events

事件说明类型版本
change选择完成后的回调(value, selectedOptions) => void-
openChange显示/隐藏浮层的回调(open: boolean) => void-

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用