更新记录

1.0.4（2024-12-31） 下载此版本

修改HX最低版本号

1.0.3（2024-12-31） 下载此版本

异步无限级联选择器

1.0.2（2024-12-31） 下载此版本

重新打包

平台兼容性

yannis-cascader

Yannis无限级联选择器(支持异步)

属性

• key	Type	是否必填	Description	默认值
  value	String	false	选择器显示的文本
  color	String	false	选择器颜色	#1B9CE2
  mask	String	false	遮罩层颜色	rgba(0,0,0,0.3)
  isMask	Boolean	false	点击遮罩层是否关闭弹窗	true
  animat	Boolean	false	是否开启动画	true
  safeArea	Boolean	false	是否适配底部安全区域	true
  placeholder	String	false	占位符	请选择
  cancelColor	String	false	取消按钮颜色	#333333
  confirmColor	String	false	确认按钮颜色	#1B9CE2
  title	String	false	选择器标题
  options	Array	true	选项
  valueKey	String	false	自定义 value key	value
  labelKey	String	false	自定义 label key	label
  childrenKey	String	false	自定义children key	children
  animationTime	Number	false	动画时长	500

事件

• name	Description	value
  maskClick	点击遮罩触发
  confirm	选择结束触发	所有选中的value构成的数组
  change	选择某一项时触发	selectedOptions: Array 当前选中的每一项; selectedIndexs当前选中的每一项在当前列表中的下标

options

• 示例

  options = [
  {
    value: "1",
    label: "重庆市",
    children: [    // 有children,并且长度不为0, 选择重庆市后, 直接出现子选项
      {
        value: "101",
        label: "江北区",
        children: [],
      },
      {
        value: "102",
        label: "沙坪坝区",
        children: [],
      },
    ],
  },
  {
    value: "2",
    label: "四川省",
    children: [],// 有children,但长度不为0, 选择重庆市后, 进入加载中状态,此时往children中添加子选项, 将结束loading并显示选项列表
  },
  {
    value: "3",
    label: "安徽省",
    children: "", // 没有children, 选择安徽省后, 将结束选择, 并触发 confirm 事件
  },
  ];

实现异步加载

• 如果需要异步加载某一项的子选项 children, 则将该项的children默认设置为空数组‘[]’.
• 当选中此项中, 选择器将进入加载中状态
• 此时通过异步获取此项的子选项数据后 push 到此项的children中.
• 选择器则结束加载中状态, 并渲染出选项列表