电话表单字段

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

• @link https://html.whatwg.com.cn/multipage/input.html#telephone-state-(type=tel)
• @see \Joomla\CMS\Form\Rule\TelRule 用于电话号码验证

• **类型**（必填）必须为电话。
• **名称**（必填）是字段的唯一名称。
• **标签**（必填）（可翻译）是字段的 html 标签。
• **描述**（可选）（可翻译）是字段描述。
• **默认值**（可选）（不可翻译）是默认值。
• **大小**（可选）是文本框的宽度（以字符为单位）。如果省略，则宽度由浏览器确定。size 的值不限制可以输入的字符数。
• **最大长度**（可选）限制可以输入的字符数。
• **类**（可选）是 HTML 表单字段的 CSS 类名称。如果省略，则默认值为 'text_area'。
• **只读**（可选）该字段不可更改，并将自动继承默认值。（可能的值：“true”、“1”、“readonly”设置为 true）
• **禁用**（可选）该字段不可更改，并将自动继承默认值 - 它也不会提交。（可能的值：“true”、“1”、“readonly”设置为 true）
• **必填**（可选）在提交表单之前必须填写该字段。（可能的值：“true”、“1”、“readonly”设置为 true）
• **过滤器**（可选）是要应用的过滤器。
• **消息**（可选）将显示的错误消息，而不是默认消息。
• **提示**（可选）在 html placeholder 元素中显示的文本，通常是空白字段内以较浅颜色显示的提示。
• **输入类型**（可选）设置 HTML5 输入类型
• **模式**（可选）用于验证的正则表达式模式。
• **字符计数器**（可选）（来自 Joomla 4.3）是否显示字符计数器（true 或 false）。与maxlength一起使用。默认：false。

文本字段也可以在选项子元素中包含一个数组，以便在文本字段中向用户显示建议。

由以下内容实现：libraries/src/Form/Field/TelephoneField.php

示例 XML 参数定义

<field
        name="mytelephonevalue" 
        type="telephone" 
        default="Some text" 
        label="Enter a phone number" 
        description=""
/>

示例 - 整数过滤器

使用整数过滤器确保在处理表单时去除非数字字符。

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

示例 - 原生过滤器

使用原生过滤器确保在处理表单时保留 html 代码。

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

另请参阅

• 文本区域表单字段类型