文本输入框

Text Field

填字的框:上面是标签,下面是输入区,有提示、有报错,是表单的最小单位。

全平台通用表单与输入内容区组件

大白话说明

文本输入框由标签、输入区、辅助文案三段构成:标签永远可见(别只用占位符当标签),出错时边框变色并在下方给出具体修改建议。带清除按钮、字数计数、密码可见切换都是常见配件。

什么时候用

一切需要用户打字的地方——它是表单出现频率最高的控件。

什么时候不用

选项有限(<7)的输入别用文本框让人打字,用选择器或单选,出错率立刻降下来。

细节与变体

  • 标签、占位符、已输入文字三者字号要有层级,别一样大
  • 错误信息出现时不引发布局大幅跳动(预留下方一行高度)
  • 移动端输入时自动调对键盘类型,桌面端回车有明确行为

配套效果见下方「可用效果」。

配套提示词(点开填空、复制)

可用效果

参考实现(开源)

  • shadcn/ui 组件库 ↗ MIT · 免费(MIT)

    不是装进项目的库,而是把组件源码复制进你自己的仓库——改起来毫无阻力,AI 也最熟它。

  • MUI(Material UI) ↗ MIT · 免费(MIT,核心)

    React 生态最老牌的 Material 组件库:组件全、文档厚、AI 生成命中率最高之一。

  • Chakra UI ↗ MIT · 免费(MIT)

    以可访问性为底线的 React 组件库:样式用 props 写,上手快。

相关条目