更新时间:2023-11-10 GMT+08:00
分享

下拉单选

下拉单选组件用于在下拉列表中选择某一个选项,支持自定义选项内容。例如选择性别、请假类型、产品名称、产品类型等场景。

在表单开发页面,从“基础组件”中,拖拽“下拉单选”组件至表单设计区域,如图1

图1 下拉单选

属性

  • 字段标题:该字段在页面呈现给用户的名称,默认名称为该字段类型名称。
  • 标题加粗:是否打开开关,默认关闭状态。
  • 字段状态:指成员在访问表单时,对该字段的可见、可编辑权限。
    • 只读:勾选后,页面上该字段可见、不可编辑。
    • 隐藏:勾选后,页面上该字段不可见、不可编辑。
    • 禁用:勾选后,页面上该字段仍可显示,但不可进行配置。
  • 验证:对字段做一些限制。

    必填:字段是否必填。勾选“必填”,页面展示会有提示必填。

  • 选项:下拉框可选择的选项内容。
    • 支持编辑、删除已有选项。
    • 支持自定义选项名和选项值,选项名和选项值默认是相同的。单击选项后的即可设置。
      • 选项名:在页面所看到的内容就是选项名,选项列表显示的是选项名。
      • 选项值:在组件对应数据表字段中保存的值。
    • 支持单个添加和批量添加选项,批量添加时每个选项单列一行,同时自动去除重复选项。
      • 单个添加:单击“新增选项”即可完成。
      • 批量添加:单击“批量选项”即可完成。
    • 支持设置某个选项为默认选中项,勾选每个选项前面的即可设置。
  • 占位符:下拉框未选择时,展示给用户的提示信息。
  • 宽度:字段配置框宽度占页面宽度的比例。

高级

  • 样式
    • 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。
    • 样式:使用CSS代码自定义组件样式。自定义代码支持多行输入,并高亮显示样式参数。
  • 正则校验:提交表单时触发的对字段的校验。
    • 自定义校验:是否进行自定义校验,打开后需要设置校验JS代码。当输入框在表单组件中,该设置才会生效。
    • 校验错误信息:当“自定义校验”中,JS代码返回值类型为布尔类型时,会取该参数的值为错误提示信息。当“自定义校验”中JS代码返回值类型为对象类型时,直接取返回值中的message值为错误提示信息。
      • 布尔类型:返回为“false”表示未通过校验,即校验失败,若需要配置错误提示信息,则直接设置界面上“校验错误信息”参数;返回值为“true”,表示通过校验。
      • 对象类型:返回为“{result:false, message:'对应错误提示信息'}”,表示未通过校验,message值为错误提示信息;返回为“{result:true}”,表示校验通过,一般不用带提示信息。
  • 事件:在事件中,显示了组件暴露出来的一些常用事件,供用户实现,来扩展组件的交互。整个页面有加载(on-load)事件,该事件在页面渲染完成后执行,可进行数据初始化操作。更多关于事件的介绍,请参见事件说明
分享:

    相关文档

    相关产品