跳至主要内容
版本：5.1

Textarea 表单字段

**textarea** 表单字段类型提供了一个从 h1 到 h6 的下拉列表作为选项。

  • **type**（必填）必须为textarea。
  • **name**（必填）是字段的唯一名称。
  • **label**（必填）（可翻译）是字段的 HTML 标签。
  • **rows**（必填）是可见文本区域的高度（以行为单位）。如果省略，高度由浏览器确定。rows 的值不限制可以输入的行数。
  • **cols**（必填）是可见文本区域的宽度（以字符为单位）。如果省略，宽度由浏览器确定。cols 的值不限制可以输入的字符数。
  • **description**（可选）（可翻译）是字段描述。
  • **default**（可选）（不可翻译）是默认值。
  • **class**（可选）是 HTML 表单字段的 CSS 类名。如果省略，则默认为 'text_area'。
  • **filter**（可选）是要应用的过滤器。
  • **hint**（可选）在 HTML placeholder 元素中显示的文本，通常是较浅颜色的提示，显示在空白字段内。

由以下文件实现：libraries/src/Form/Field/TextareaField.php

XML 参数定义示例​

<field
        name="mytextarea" 
        type="textarea" 
        default="default" 
        label="Enter some text" 
        description="" 
        rows="10" 
        cols="5"
/>

使用 raw 过滤器可确保在处理表单时保留 HTML 代码

<field
        name="mytextarea" 
        type="textarea" 
        default="default" 
        label="Enter some text" 
        description="" 
        rows="10" 
        cols="5"
        filter="raw"
/>

提示​

如果您需要换行，只需在 XML 配置文件中编码<br />，如下所示：&lt;br /&gt;
如果您的默认值中需要换行符，请在 default 参数中添加&#13;&#10;。

另请参阅​