跳到主要内容

字段
就绪
Storybook

Field 组件是用于处理表单输入元素(如文本输入框、开关或其他自定义输入组件)的包装器。它提供了标签、描述、验证状态和布局选项等功能。

何时使用

Field 组件适用于需要在 React 应用中集成表单输入的各种场景。一些常见的用例包括:

  • 创建带有标签的输入元素表单。
  • 添加描述以帮助用户理解输入的用途。
  • 对表单字段应用验证和错误消息。
  • 指示输入字段的加载或禁用状态。

实现 / 选项

请注意,Field 组件会将 invaliddisabledloading 属性(除非它们是 undefined)传递给子组件;如果这些属性已在子组件上设置,则会覆盖子组件上的值。

加载中...
实时编辑器
<Field label="API key" description="Your instance API key">
  <Input id="api-key" />
</Field>

注意事项 (推荐)

  • 为字段提供有意义的标签以增强可访问性。
  • 为字段提供描述,以帮助用户理解输入的用途。

注意事项 (不推荐)

  • 在不提供标签的情况下使用 description 属性。
  • 在不提供错误消息的情况下使用 invalid 属性。

验证

使用 invalid 属性来指示输入无效。这将在输入框周围添加红色边框,并显示 error 属性中提供的错误消息。要使其工作,必须同时设置 invaliderror 属性。

加载

使用 loading 属性来指示输入正在加载。这将在输入框中添加加载指示器(spinner)。

演练场