SuperAPI AI 工具集

sgds-components-select

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

<sgds-select> 是 SGDS 提供的可搜索表单选择控件,选项以 <sgds-select-option> 子元素提供,内置过滤、标签、提示文字、加载状态和校验反馈。仅支持单选;需要多选时改用 <sgds-combo-box multiSelect>。前置条件参见 sgds-components-setup 了解安装与框架集成(React 19+ 与 React ≤18、Vue、Angular)。该组件不暴露自定义属性与 CSS part,不能修改 CSS 样式。

主要属性(<sgds-select>):label 字段标签、hintText 标签下提示文字、name 提交表单字段名、value 当前选中值、placeholder 未选中时占位文字、required 必填、disabled 禁用、loading 显示加载旋转、hasFeedback 启用校验反馈 UI、invalidFeedback 无效时错误信息、readonly 只读。<sgds-select-option> 支持 value(提交及存入父级的值)与 disabled 禁用选项。

用法要点:选项必须设置 value 属性,父级 value 会反映选中选项的 value;预选值时把 value 设为对应选项的 value。校验反馈需设置 hasFeedback 与 invalidFeedback。异步或加载状态设置 loading。默认插槽用于放置 <sgds-select-option> 元素,选项的默认插槽为选项标签文字。该组件没有公开方法。

事件:sgds-select(选中某项时触发)、sgds-change(值变化)、sgds-focus(获得焦点)、sgds-blur(失去焦点)。检测用户选择应使用 sgds-select(而非 sgds-change),并通过 element.value 读取选中值。

限制:仅单选;不支持 CSS 样式修改;无公开方法。其余细节(如价格或平台支持)资料未提供。