级联单选-桌面端|飞书低代码平台

级联单选-桌面端|飞书低代码平台

飞书低代码平台手册精选NaN-NaN-NaN
产品功能
适用场景
cascaderSelect,多级选择器,常使用在地域选择、SKU选择等场景。
使用说明
区域
说明
示意图
内容区
  • 级联选择只支持mapped模式
  • 默认值
  • 级联单选的默认值类型是array
  • 级联单选的值类型是个数组,会将所选择的节点的完整路径记录下来
例如行政区划选择,选择了浙江省-杭州市-西湖区,级联单选组件的值是:
[ "浙江省" , "杭州市" , "西湖区" ]
  • 默认值会在组件初始化、重置、以及依赖的变量发生变化后生效
  • 占位符
  • 占位符属性的类型是string
  • 拓展
  • 标题
250px|700px|reset
内容区示意图
250px|700px|reset
交互区
  • form data key
  • 表单内的输入类组件配置了「form data key」后,表单可获取到该组件的值。
比如,文本输入组件的「form data key」配置为"first_name",表单的data信息中会包含"first_name",并且其值为该文本输入组件的值,可以通过{ { form.data.first_name } }消费该组件的值
  • 同一个表单内有多个相同「form data key」时,均不会生效
  • 可选层级
  • 任意层级
  • 可以选择任意一级的节点
  • 最后一级
  • 只能选择叶子节点
  • 只能选择指定层级
  • 只能选择指定的层级的节点
  • 事件
  • 支持4种事件:「值改变时」、「聚焦时」、「失焦时」、「搜索时」
  • 校验
  • 校验时机:聚焦时、值改变时、表单提交时(如在表单内)
  • 校验内容:
  • 必填
  • 自定义校验规则
  • 可以通过js表达自定义校验规则
示例:{{self.value === 'test' ? 'error': ''} }
  • 只读
  • boolean类型
  • 效果
250px|700px|reset
  • 禁用
  • boolean类型
  • 效果
250px|700px|reset
  • 加载中
  • boolean类型
  • 效果
250px|700px|reset
250px|700px|reset
外观区
  • 清空按钮
  • 当级联单选组件的值不为空的时候,hover到组件上会出现清空按钮,支持一键清空组件的值
  • 回填显示层级
回填显示层级为true时:
会在组件上显示完整路径
250px|700px|reset
250px|700px|reset
回填显示层级为true时:
只会显示所选节点的标题
  • 隐藏
  • boolean类型,控制输入组件是否在页面上隐藏
250px|700px|reset
属性 API
方法
setValue(value: boolean | string | number | void)
设置组件值
clearValue()
清空组件值
validate()
触发校验
clearValidation()
清空校验状态
reset()
重置组件值
setDisabled(disabled: boolean)
设置是否禁用
setLoading(loading:boolean)
设置是否加载中
setHidden(visible:boolean)
设置是否隐藏
setReadOnly(readOnly:boolean)
设置是否只读
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
联系我们立即试用