文档

下拉单选

更新时间:

使用场景

当需要在限定的可选项内进行单项选择时,您可以选择使用下拉单选组件。

使用说明

在某个容器内或整个页面内拖入下拉单选组件,需要绑定一个类型为List<Structure>类型的变量,其中Structure为下拉单选中每项数据对应的类型。

使用示例

说明

本文以已存在可绑定变量,无需新增变量为例说明。

  1. 组件面板拖拽下拉单选组件至画布。在新增变量对话框中,单击image图标。image

  2. 绑定变量,即给下拉单选绑定初始值。image

  3. 配置提示信息(展示在下拉单选框中的提示文字)。image

  4. 配置描述文字(对下拉单选进行修饰说明的文字)。image

  5. 配置选项配置,其选项来源支持固定值动态值

    • 固定值:您可单击编辑数据,在数据编辑对话框中,按需进行添加、编辑与删除操作。image

    • 动态值:您需要绑定一个类型为List<Structure>类型的变量,其中Structure为下拉单选组件中每项数据对应的类型。image

  6. 配置其他配置image

    • 当开启清除按钮后,您可以一键清除选中的内容。2

    • 当开启搜索功能后,您可以在下拉单选框中输入您想搜索的内容,下拉单选框会根据你输入的内容显示过滤结果,页面效果如下图所示。6

    • 设置搜索结果为空的文案,当您搜索的关键字不存在对应匹配项时下拉框中会给出对应的提示。1

    • 如果选项来源设置为动态值,您需要关闭本地搜索过滤开关。

      如果选项来源设置为固定值,您可以自定义本地搜索过滤方法。单击绑定动作,在自定义本地搜索过滤方法对话框中,您可以选择在页面JS全局JS中输入对应的方法。image

  7. 配置校验

    • 开启校验必填开关,设置校验未通的提示信息。image

    • 您可以开启自定义校验开关,按需编辑校验代码。image