文本字段

了解 Toolpad Studio 中的文本字段组件及其用法。

演示

TextField 是一个文本输入组件。它接收用户输入并提供值，以便在页面上进一步使用。

用法

它是最常用的输入组件之一。下面的视频使用了一些属性来演示其用法。

值

当前值。

默认值

允许设置默认值。如果用户未输入任何内容，则使用默认值。

密码

密码属性会遮盖用户输入。它用于隐藏敏感数据。

名称

当文本字段是表单组件的一部分时，需要一个名称。它用于显示验证错误。

外观

TextField 组件在 Toolpad Studio 中支持以下提到的外观相关属性

标签

一个描述文本字段内容的标签，例如“输入姓名”。

变体

variant 属性支持三个不同的选项：outlined（轮廓型）（默认）、filled（填充型）和 standard（标准型）。 Outlined 用于低强调，而 filled 是高强调输入。 Standard 用于不太明显的动作，以确保用户保持专注于主要内容。

尺寸

size 属性支持两个选项：small（小型）（默认）和 medium（中型）。

完整宽度

此布尔值定义组件是否应占据页面的完整宽度。

占位符

如第一个演示所示，在空白文本字段中，当用户开始输入时，会出现一个占位符。

禁用

禁用属性显示组件的状态，以便最终用户知道他们无法与组件交互。

验证

验证属性提供了为各种场景创建交互式文本字段组件的选项。这些在 Toolpad Studio 编辑器中以复选框配置的形式提供。

必填项

isRequired 属性用于在未提供值时显示错误消息。它可以用于必填字段。

最小长度

根据提供的文本值的最小必需长度显示错误消息。例如，它可以用于确保提供的密码足够长。

在下面的演示中，输入必须超过 6 个字符，否则会显示验证错误。

最大长度

根据提供的文本值的最大必需长度显示错误消息。与其他属性结合使用，它可以用于强制执行邮政编码或电话号码的长度，例如。

在下面的演示中，输入必须不超过 6 个字符，否则会显示验证错误。

API

请参阅下面的文档，以获得 Toolpad Studio 中文本字段组件所有可用属性的完整参考。

• <textfield />