# lay_cascader
**Repository Path**: tonyweb/lay_cascader
## Basic Information
- **Project Name**: lay_cascader
- **Description**: layui cascader 仿element-ui级联选择器
- **Primary Language**: JavaScript
- **License**: BSD-3-Clause
- **Default Branch**: main
- **Homepage**: https://yixiaco.github.io/lay_cascader/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 68
- **Created**: 2025-02-23
- **Last Updated**: 2025-02-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# lay_cascader
[](https://gitee.com/yixiacoco/lay_cascader)
[](https://github.com/yixiaco/lay_cascader)
[](https://gitee.com/yixiacoco/lay_cascader/blob/main/LICENSE)
> layui cascader 仿element-ui级联选择器
**演示页面**:https://yixiaco.github.io/lay_cascader/
**gitee**:https://gitee.com/yixiacoco/lay_cascader
**github**: https://github.com/yixiaco/lay_cascader
## Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
| --------------------- | :----------------------------------------------------------- | :---------------------- | :----------- | :--------- |
| elem | 绑定元素 | String/jqueryObject/DOM | - | - |
| value | 预设值 | Object/Array | - | null |
| props | 配置选项,具体见下表 | Object | - | - |
| options | 可选项数据源,键名可通过 props 属性配置 | Array | - | [] |
| empty | 无匹配选项时的内容 | String | - | '暂无数据' |
| placeholder | 输入框占位文本 | String | - | '请选择' |
| disabled | 是否禁用 | Boolean | true / false | false |
| clearable | 是否支持清空选项 | Boolean | true / false | false |
| showAllLevels | 输入框中是否显示选中值的完整路径 | Boolean | true / false | true |
| collapseTags | 多选模式下是否折叠Tag | Boolean | true / false | false |
| minCollapseTagsNumber | 最小折叠标签数 | Number | - | 1 |
| separator | 选项分隔符 | String | - | ' / ' |
| filterable | 是否可搜索选项 | Boolean | true / false | false |
| filterMethod | 自定义搜索逻辑,第一个参数是节点node,第二个参数是搜索关键词keyword,通过返回布尔值表示是否命中 | Function | - | - |
| debounce | 搜索关键词输入的去抖延迟,毫秒 | Number | - | 300 |
| beforeFilter | 筛选之前的钩子,参数为输入的值,若返回 false,则停止筛选 | Function | - | - |
| popperClass | 自定义浮层类名 | String | - | '' |
| extendClass | 继承class样式 | Boolean | true / false | false |
| extendStyle | 继承style样式 | Boolean | true / false | false |
| disabledFixed | 固定禁用项,使禁用项不被清理删除,禁用项只能通过函数添加或初始值添加,默认禁用项不可被函数或初始值添加 | Boolean | true / false | false |
| maxSize | 多选选中的最大数量,0表示不限制 | Number | >=0 | 0 |
## Props
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
| ------------- | :----------------------------------------------------------- | :----------------------------------------------------------- | :------------ | :--------- |
| strictMode | 严格模式,设置value严格按照层级结构.获取的value和Node也将按照层级结构返回.
例如:
多选:
[['zhinan','shejiyuanze','yizhi']]
单选:
['zhinan','shejiyuanze','yizhi'] | Boolean | true / false | false |
| expandTrigger | 次级菜单的展开方式 | String | click / hover | 'click' |
| multiple | 是否多选 | Boolean | true / false | false |
| checkStrictly | 是否严格的遵守父子节点不互相关联 | Boolean | true / false | false |
| lazy | 是否动态加载子节点,需与 lazyLoad 方法结合使用 | Boolean | true / false | false |
| lazyLoad | 加载动态数据的方法,仅在 lazy 为 true 时有效 | Function(node, resolve),node为当前点击的节点,resolve为数据加载完成的回调(必须调用) | - | - |
| value | 指定选项的值为选项对象的某个属性值 | String | - | 'value' |
| label | 指定选项标签为选项对象的某个属性值 | String | - | 'label' |
| children | 指定选项的子选项为选项对象的某个属性值 | String | - | 'children' |
| disabled | 指定选项的禁用为选项对象的某个属性值 | String | - | 'disabled' |
| leaf | 指定选项的叶子节点的标志位为选项对象的某个属性值 | String | - | 'leaf' |
## Option
| 选项名称 | 说明 | 类型 | 示例 |
| -------- | ---------------------- | --------------------- | ------------------------------------- |
| value | 指定选项的值 | String、Number、Array | '1'、1、[1]、[[1,2],[1,3]] |
| label | 指定选项标签 | String | '广东' |
| children | 指定选项的子选项 | Array