文本表单字段

**文本** 表单字段类型提供了一个文本框用于数据输入。如果该字段保存了值，则在页面首次加载时会显示此值。如果没有，则选择默认值（如果有）。

• **type**（必填）必须为*text*。
• **name**（必填）是字段的唯一名称。
• **label**（必填）（可翻译）是字段的 HTML 标签。
• **description**（可选）（可翻译）是字段描述。
• **default**（可选）（不可翻译）是默认值。
• **size**（可选）是文本框的宽度（以字符为单位）。如果省略，则宽度由浏览器确定。size 的值不会限制可以输入的字符数。
• **maxlength**（可选）限制可以输入的字符数。
• **class**（可选）是 HTML 表单字段的 CSS 类名。如果省略，则默认为'text_area'。
• **readonly**（可选）该字段不能更改，并将自动继承默认值。（可能的取值："true"，"1"，"readonly" 设置为 true）
• **disabled**（可选）该字段不能更改，并将自动继承默认值 - 它也不会提交。（可能的取值："true"，"1"，"readonly" 设置为 true）
• **required**（可选）在提交表单之前必须填写该字段。（可能的取值："true"，"1"，"readonly" 设置为 true）
• **filter**（可选）是过滤器应用。
• **message**（可选）将显示的错误消息，而不是默认消息。
• **hint**（可选）在 HTML 占位符元素中显示的文本，通常是空白字段内显示的浅色提示。
• **inputtype**（可选）设置 HTML5 输入类型
• **pattern**（可选）用于验证的正则表达式模式。
• **charcounter**（可选）（从 Joomla 4.3 开始）显示字符计数器（true 或 false）。与maxlength一起使用。默认值：false。

文本字段还可以包含一系列选项子元素，以便在文本字段中向用户显示建议。

由以下代码实现：libraries/src/Form/Field/TextField.php

示例 XML 参数定义

<field
        name="mytextvalue" 
        type="text" 
        default="Some text" 
        label="Enter some text" 
        description="" 
        size="10"
/>

示例 - 使用整数过滤器确保在处理表单时删除字母类型。

<field 
        name="myintvalue" 
        type="text" 
        default="8" 
        label="Enter some text" 
        description="Enter some description" 
        filter="integer" 
/>

示例 - 使用 raw 过滤器确保在处理表单时保留 HTML 代码。

<field
        name="myintvalue"
        type="text"
        default="8"
        label="Enter some text"
        description="Enter some description"
        filter="raw"
/>

另请参阅

• 多行文本表单字段类型