SuperAPI AI 工具集

sgds-components-combo-box

数据与分析

查看项目

更新于 10-16 05:49

技能介绍

用途:sgds-combo-box 是 SGDS(新加坡政府设计系统)提供的可搜索下拉选择组件,默认在客户端进行过滤,可用于表单中选择国家、标签、用户等选项。

主要能力:单选用默认形态;加 multiSelect 支持多选并以可移除徽标展示,多选值为逗号分隔字符串;加 async 关闭客户端过滤、改为服务端异步过滤;clearable 显示清除按钮;badgeFullWidth 让多选徽标占满宽度;filterFunction 可传自定义过滤函数(JS 属性形式,不可作为 HTML attribute,async 为 true 时被忽略);emptyMenuAsync 在异步模式下打开时显示空菜单;menuIsOpen 可编程控制下拉展开;floatingOpts 用于 Floating UI 定位。选项由 sgds-combo-box-option 子元素提供,可设 value 与 disabled。

用法:通过属性 label、hintText、name、placeholder、required、disabled、readonly、loading 等配置;事件包括 sgds-select、sgds-change、sgds-input(detail 含 displayValue)、sgds-focus、sgds-blur。异步过滤时监听 sgds-input,取 event.detail.displayValue 请求服务端,再替换 combo-box-option 子元素。安装与框架集成见 sgds-components-setup,未见具体安装命令。

限制:组件不暴露自定义属性与 CSS part,不能修改样式。React 19+ 与 React ≤18、Vue、Angular 的集成差异需参考 setup 文档。具体可用平台、包名、版本与安装命令资料暂未提供。