# Addon Input Group

https://fieldbook.lizardi.mx/zh/components/addon-input-group

分类：输入控件
缩略图：https://fieldbook.lizardi.mx/thumbs/addon-input-group.webp

Addon Input Group：共用边框的输入框组合，可放置前置图标、尾部按钮或文字，整个组合共用一个焦点环。

## 框架

react、vue、svelte、astro、html

## 预览控件

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

| 名称 | 类型 | 默认值 | 选项或限制 |
| --- | --- | --- | --- |
| placeholder | text | Search components... | 最多 40 个字符 |
| trailingLabel | text | Search | 最多 16 个字符 |
| accentColor | color | #38BDF8 | 元数据未列出其他限制。 |
| showLeadingIcon | boolean | true | 元数据未列出其他限制。 |

## 使用说明

当文本输入框及其操作属于一组时，可使用此输入组合，例如目录搜索。

Addon Input Group 的预览采用「行内」布局，主题设置为「浅色/深色」。

将搜索图标置于输入框前，并将末尾按钮连接到搜索处理函数。共享焦点环让输入时的组合保持视觉关联。

组件提供输入控件和展示层。应用需要提供无障碍标签、处理搜索并校验提交值。

### 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 直接读取偏好的代码。请启用减少动态效果，检查完整实现、共享样式和所选框架版本；这些观察不能证明所有动画都会停止。

## 通过 MCP 安装

连接客户端，调用 get_component 获取实现，再调用 get_install_command 获取安装说明。选择已列出的框架，将源代码集成到应用中并验证功能。

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "addon-input-group",
    "framework": "react"
  }
}
```

[面向智能体](https://fieldbook.lizardi.mx/zh/docs/agents)
[MCP](https://fieldbook.lizardi.mx/api/mcp)

## 相关开放组件

- [Auto Grow Textarea](https://fieldbook.lizardi.mx/zh/components/auto-grow-textarea)
- [Focus ring text input](https://fieldbook.lizardi.mx/zh/components/focus-ring-text-input)
- [Select All Checklist](https://fieldbook.lizardi.mx/zh/components/indeterminate-select-all)
- [Input with affix](https://fieldbook.lizardi.mx/zh/components/input-group-affix)
- [Orbit drop zone](https://fieldbook.lizardi.mx/zh/components/orbit-drop-zone)
- [Single value slider](https://fieldbook.lizardi.mx/zh/components/single-value-slider)