跳到主内容

输入
就绪
Storybook

一个允许用户编写或编辑文本的基础组件。

何时使用

在表单中使用输入框帮助用户输入、选择和搜索文本。输入框通常位于表单中,但也可是模态框、搜索或卡片的一部分。

表单用法

输入框应与 字段 组件一起使用,以便为输入框提供标签和描述。

加载中...
实时编辑器
<Field label="Username">
  <Input placeholder="Enter username" />
</Field>

实现 / 选项

占位文本

输入框可以有占位文本。请谨慎使用占位文本,因为它经常与实际文本混淆。将占位文本误认为是实际文本常常导致用户遗漏需要填写的输入项,从而产生较高的错误率。当输入框与字段一起使用时,应优先使用标签和描述,而不是占位文本。

输入框内的前缀或后缀

输入框可以在开头或结尾处放置元素,例如图标。这使得可以创建带有放大镜图标的搜索字段等输入框。

加载中...
实时编辑器
<Input prefix={<Icon name="search" />} placeholder="Search dashboards" />
加载中...
实时编辑器
<Input suffix={<Icon name="plus-circle" />} />

输入框之前或之后的附加组件

一种附加物,通常是按钮,可以出现在输入框之前或之后。

加载中...
实时编辑器
<Input addonAfter={<Button variant="secondary">Load</Button>} />

类型和行为

文本

文本输入框允许用户输入文本、数字和特殊字符。

数字

数字输入框限制用户只能输入数字字符。

密码

密码输入框会隐藏用户输入的字符。

状态

无效

输入框的无效状态表示提供的内容需要更正或添加额外内容,用户才能继续操作。

加载中

在某些情况下,输入框可以指示其正在加载。

禁用

根据用户权限或输入框是否与数据源同步,输入框可以处于禁用状态。

演练场