Syncfusion React Inputs 是一套面向 React 应用的输入类 UI 组件集合，本技能文档以实施指南的形式，介绍如何在 React 项目中引入、配置和定制这些输入控件。文档覆盖的组件包括 Uploader、NumericTextBox、TextBox、TextArea、CheckBox、OTP Input、Signature 等。
一、用途 该组件集用于在 React 应用中构建各类用户输入界面，包括文件上传、数字录入与格式化、文本输入、多行文本、复选框、一次性验证码输入和签名等。文档同时强调代理式使用规范：不要自主执行多步操作，安装、运行、创建文件等每个动作前都应先与用户确认。
二、主要能力
- Uploader（文件上传）：支持异步上传、拖放、分块上传（含暂停/恢复/取消）、验证、模板、表单集成和无障碍支持。可配置 saveUrl 与 removeUrl、多文件与单文件上传、自动与手动上传、顺序上传、预加载文件、自定义 HTTP 头、分块大小与重试、允许的扩展名、文件大小限制、最大文件数、重复文件防护、剪贴板粘贴上传、目录上传、自定义拖放区域、文件列表模板、自定义按钮、进度条定制、编程式上传、图片预览与压缩、JWT 认证、表单支持、本地化和键盘导航等。
- NumericTextBox（数字输入框）：支持数字格式化（货币、百分比、科学计数法）、最小/最大范围验证、微调按钮、小数精度控制、国际化、RTL 语言以及 WCAG 2.2 无障碍合规。可配置 value、min、max、step、decimals、format、currency、placeholder、floatLabelType、readonly、enabled、strictMode、validateDecimalOnType、showSpinButton、showClearButton、allowMouseWheel、cssClass、width 等属性。
- TextBox（文本输入框）：轻量级文本输入控件，支持浮动标签、验证状态、图标和高级特性。可配置 placeholder、floatLabelType、value、type、cssClass、multiline、showClearButton、enabled、readonly、enableRtl 等属性，支持三种尺寸（Normal、Small、Large）、圆角、多行文本、自动调整大小、字符计数、错误/警告/成功验证状态、前置与后置模板装饰等。
三、使用方式 文档以参考文件导航的形式组织内容，每个组件下分设 getting-started、api、各功能专题等参考文件。安装方式为通过 npm 安装 @syncfusion/ej2-react-inputs 包，并导入相应 CSS 主题（如 material.css、material3.css）。文档给出多个可直接参考的 JSX/TSX 示例，例如 Uploader 的异步上传配置、NumericTextBox 的受控组件写法、TextBox 的浮动标签与图标用法等。文档明确要求：不要自主安装包，应让用户执行 npm install @syncfusion/ej2-react-inputs，并固定版本、用 npm audit 验证；不要自主启动开发服务器。
四、适用场景 适用于需要在 React 应用中实现文件上传（含大文件分块、目录上传、图片预览）、数字格式化输入（货币、百分比、评分、数量、测量值、财务表单）、文本输入（含浮动标签、验证状态、多行文本、装饰图标）等场景。文档还给出常见模式，如购物车数量输入、价格计算器、评分范围、折扣百分比、测量输入和财务表单等。
五、限制与注意事项 文档强调安全事项：不要硬编码令牌，应从安全会话存储在运行时获取；不要记录请求头或令牌值；不要在生产环境使用第三方演示 URL，否则文件会被发送到外部服务器。包依赖方面，@syncfusion/ej2-react-inputs、@syncfusion/ej2-base、@syncfusion/ej2-buttons 需存在于 package.json 中，并建议使用显式版本范围以避免未固定依赖风险。关于收费、价格、平台支持范围等具体信息，资料中暂未提供。