Select 控件介绍

Select 从静态选项、Custom URL 或 Model 数据源中选择一个或多个值。它会加入所在 Form 的字段状态、校验和提交范围。

1. 适用场景

常见用途：

• 状态、类型和枚举值
• 可搜索的长选项列表
• 由后端动态返回的选项

2. 添加与配置

1. 把 Select 添加到 Form Section 的 Fields 区域。
2. 设置稳定且唯一的 Field Key / Name，并让它与后端 DTO 属性一致。
3. 配置本页列出的组件属性，再按需要设置 Required、Help Text、Full row 和条件表达式。
4. 在设计预览中检查初始值和布局，并使用 Form 的 Validate / Submit 验证完整数据链路。

3. 主要属性

属性	作用
Options	定义可选数据的来源和映射方式。
Data Source	定义可选数据的来源和映射方式。
Multiple	启用或关闭该行为。
Selectable Count	限制允许的数量、长度或取值范围。
Enable Search Box Input	启用或关闭该行为。
Disabled	启用或关闭该行为。

Field Key、Required、Help Text、Full row、Visible When 等通用属性由 Form 字段契约提供；本表列出的是使用 Select 时最需要关注的配置。

4. 表单值与后端契约

该字段提交的值： 单选时为一个稳定选项值，多选时为选项值数组。

"engineering"

["engineering", "product"]

示例仅说明数据形状；接口仍应按业务 DTO 校验类型、范围和权限。

5. 校验、条件与交互

所有字段都可使用 Form 的 Required、Visible When、Disabled When、Required When、Dependencies 和 Clear When Hidden。条件表达式只控制交互，不代替后端权限与校验。

组件能力： 支持 onChange；选择变化后可以继续执行 Page Interaction。

6. 使用建议

配置建议： 选项值应稳定且适合作为后端枚举或标识；用户可见文案可以国际化，但不要用文案本身作为业务主键。

返回 Form 总览，了解布局、校验、提交、草稿和后端协议。