输入控件
Addon Input Group
Addon Input Group:共用边框的输入框组合,可放置前置图标、尾部按钮或文字,整个组合共用一个焦点环。
使用 Addon Input Group
当文本输入框及其操作属于一组时,可使用此输入组合,例如目录搜索。
Addon Input Group 的预览采用「行内」布局,主题设置为「浅色/深色」。
将搜索图标置于输入框前,并将末尾按钮连接到搜索处理函数。共享焦点环让输入时的组合保持视觉关联。
组件提供输入控件和展示层。应用需要提供无障碍标签、处理搜索并校验提交值。
自定义预览
这些控件会传给演示组件。默认值和限制描述的是预览;完整的属性接口请查看实现代码。
| 控件 | 类型 | 默认值 | 预览限制 |
|---|---|---|---|
placeholder | text | Search components... | 最多 40 个字符 |
trailingLabel | text | Search | 最多 16 个字符 |
accentColor | color | #38BDF8 | 元数据未列出其他限制。 |
showLeadingIcon | boolean | true | 元数据未列出其他限制。 |
Addon Input Group 提供哪些框架版本?
Addon Input Group 提供 React、Vue、Svelte、Astro、HTML 版本。实时预览使用 React;以下代码观察仅针对 index.tsx。使用其他版本前,请确认其交互行为。
Addon Input Group 有哪些依赖?
React 元数据列出的额外 npm 依赖为:clsx。
Addon Input Group 的代码中有哪些无障碍细节?
Addon Input Group 的 React 代码包含:原生元素(button、input);属性与事件处理器(aria-hidden、aria-invalid)。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。
Addon Input Group 如何处理减少动态效果的偏好?
代码扫描未在 Addon Input Group 的 index.tsx 中发现通过 useReducedMotion() 或 matchMedia 直接读取偏好的代码。请启用减少动态效果,检查完整实现、共享样式和所选框架版本;这些观察不能证明所有动画都会停止。