用途
Syncfusion React TextBox 组件是一个轻量级的输入控件，用于捕获用户文本输入，支持浮动标签、验证状态、图标和高级特性。本技能指导开发者在 React 应用程序中实现、配置和自定义 TextBox 组件。
主要能力
- 浮动标签行为：Never、Always、Auto 三种模式。
- 图标：通过 addIcon() 方法在输入框前置（prepend）或后置（append）添加图标。
- 清除按钮：通过 showClearButton 属性显示清除按钮。
- 圆角：使用 e-corner CSS 类实现圆角。
- 禁用状态：使用 enabled={false}（而非 disabled）。
- 多行文本框：通过 multiline={true} 创建 textarea 输入，支持浮动标签、自动调整大小、禁用调整大小、限制文本长度（htmlAttributes={{ maxlength: '...' }}）以及字符计数显示。
- 样式与尺寸：三种预定义尺寸 Normal、Small（e-small）、Large（e-bigger），通过 cssClass 属性应用尺寸类；支持 CSS 自定义和主题、响应式设计模式。
- 验证与状态：通过 cssClass 应用 error、warning、success 验证状态（e-error、e-warning、e-success）；支持只读状态 readonly={true}；支持基于 input 事件的动态颜色变化。
- 高级特性：通过 prependTemplate 和 appendTemplate 属性实现装饰（adornments），包括交互式装饰（密码切换、删除按钮）；集成 React 函数组件与 hooks（useState、useEffect、useRef、useReducer）；事件处理（created、input、change 等）；表单验证模式。
使用方式
该技能以文档导航形式组织，开发者按需阅读 references 目录下的对应文档：
- 入门（getting-started.md）：Vite 设置、安装 @syncfusion/ej2-react-inputs 包、添加 CSS 导入和主题、创建第一个 TextBox 组件、添加图标和浮动标签、运行开发服务器。安装命令为：npm install @syncfusion/ej2-react-inputs，建议固定版本（如 @syncfusion/ej2-react-inputs@28.x.x）并用 npm audit 验证；运行开发服务器命令为 npm run dev。
- 特性与分组（features-and-groups.md）：浮动标签、图标、清除按钮、圆角、禁用状态、多行文本框及组合用法。
- 样式与尺寸（styling-and-sizing.md）：预定义尺寸、尺寸类、圆角、CSS 自定义、主题与响应式。
- 多行文本框（multiline-textbox.md）：多行创建、浮动标签、自动调整大小、禁用调整、长度限制、字符计数。
- 验证与状态（validation-and-states.md）：验证状态类、禁用与只读的区别、动态颜色变化。
- 高级特性（advanced-features.md）：装饰模板、交互式装饰、React hooks 集成、事件处理、表单验证。
- 无障碍与迁移（accessibility-and-migration.md）：WCAG 2.2、Section 508、WAI-ARIA 合规、屏幕阅读器支持、RTL（enableRtl 属性）、键盘导航、从 CSS TextBox 迁移。
- API 参考（api.md）：全部属性、方法和事件。
代码示例包括：带浮动标签的基础 TextBox、带图标的 TextBox、带清除按钮的 TextBox、多行 TextBox、带验证状态的表单、带切换的密码 TextBox、带单位标签的邮箱输入、圆角 TextBox、禁用 TextBox、RTL TextBox、自动调整大小的多行 TextBox。
适用场景
适用于在 React 应用中需要文本输入字段的场景，例如表单、登录、注册、搜索、地址输入、密码输入、邮箱输入等，尤其是需要浮动标签、验证状态、图标或 RTL 支持时。
限制
- 该技能文档中带有代理（agentic）使用警告：不要自主执行多个步骤，每个操作（安装、运行、文件创建）前需与用户确认。不要自主安装包，应让用户运行安装命令；不要自主启动开发服务器，应让用户运行 npm run dev。
- enablePersistence 属性会在浏览器存储中保存数据（⚠️），仅在用户明确同意时启用。
- 外部链接（Syncfusion 演示、API 参考、React Inputs 包）仅供手动参考，不要在无用户明确同意的情况下在代理管道中自动抓取这些 URL。
- 关于收费、价格、平台等具体信息，资料中暂未提供。