跳至正文
菜单

输入控件

Combobox field

Combobox field:可搜索的下拉输入框,输入时实时筛选选项,选中后将选项填入字段。

使用 Combobox field

Combobox field 的预览采用「卡片」布局,主题设置为「浅色/深色」。

自定义预览

这些控件会传给演示组件。默认值和限制描述的是预览;完整的属性接口请查看实现代码。

控件类型默认值预览限制
placeholdertextSearch frameworks...最多 40 个字符
accentcolor#38BDF8元数据未列出其他限制。
openOnLoadbooleanfalse元数据未列出其他限制。
Combobox field 提供哪些框架版本?

Combobox field 提供 React、Vue、Svelte、Astro、HTML 版本。实时预览使用 React;以下代码观察仅针对 index.tsx。使用其他版本前,请确认其交互行为。

Combobox field 有哪些依赖?

React 元数据列出的额外 npm 依赖为:motion、clsx、tailwind-merge。

Combobox field 的代码中有哪些无障碍细节?

Combobox field 的 React 代码包含:原生元素(button、input);属性与事件处理器(aria-activedescendant、aria-autocomplete、aria-controls、aria-expanded、aria-haspopup、aria-hidden、aria-label、aria-selected、onKeyDown、tabIndex);显式角色(combobox、listbox、option);按键比较(ArrowDown、ArrowUp、Enter、Escape)。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。

Combobox field 如何处理减少动态效果的偏好?

Combobox field 的 React 代码通过 useReducedMotion() 读取动态效果偏好。index.tsx 中随偏好变化的表达式:reduceMotion ? false : { opacity: 0, y: -6, scale: 0.98 };reduceMotion ? undefined : { opacity: 0, y: -6, scale: 0.98 }。请启用减少动态效果,检查完整实现、共享样式和所选框架版本;这些观察不能证明所有动画都会停止。

连接你的智能体

相关开放组件