用途:在需要用户输入或编辑自由文本时使用该技能,例如登录认证(用户名、密码、邮箱)、搜索框、表单与问卷、消息与评论界面,以及标签、描述、评论等数据录入字段。
主要能力:覆盖单行与多行输入,支持占位提示、字符计数、校验消息与格式辅助;给出适用与应避免场景:预定义选项改用下拉、单选或复选框,结构化数据改用日期选择器或货币字段,短选择改用自动完成,语音输入或选择更合适时考虑替代方案。
使用方式:先确认模式与问题、约束匹配,再参照 references/pattern.md 中的结构与示例选择最小可行变体;先落实可访问性、性能与交互护栏,再做视觉打磨;用测试指引验证键盘、屏幕阅读器、响应式与失败场景。键盘交互包括 Tab、Shift+Tab、表单内 Enter 提交、左右方向键移动光标、多行上下方向键移动光标、搜索框内 Esc(可选)清空输入。性能目标:初始渲染 <100ms,点击到聚焦 <50ms,校验反馈 <150ms,字符计数更新 <50ms,每实例内存 <5KB。
限制与注意:不要把占位符当作唯一标签,应提供可见 label,placeholder 仅作提示;校验时机应渐进,首次输入在失焦后显示错误,之后可实时校验,必填项在失焦时校验、格式在输入时校验;错误信息需具体可执行并给出示例,避免“Invalid input”这类模糊提示。完整实现细节、示例与测试说明见 references/pattern.md。