URL 表单字段

url 表单字段类型提供了一个用于数据输入的文本框，该文本框会过滤为完全限定的 URL。此字段本质上是一个类型为 url 的文本字段。如果输入了完全限定的 url（即具有方案和域的 url，例如 http://example.com）并且它使用 idn（即使用非 ASCII 字符，例如 ê 或 Ψ），它会在保存之前将 url 转换为 Punycode。这确保了无论环境如何，url 都会按预期工作。如果要以 idn 呈现字段数据，则应将其包装在转换方法中

use Joomla\CMS\String\PunycodeHelper;
$value = PunycodeHelper::urlToPunycode($value);

• type（必填）必须为url。
• 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（可选）是要应用的 过滤器。
• hint（可选）在 html placeholder 元素中显示的文本，通常是显示在空白字段内的较浅颜色的提示。
• validate（可选）进行验证。
• relative（可选）对于相对 URL 设置为 true。

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

XML 参数定义示例

<field
        ame="mytextvalue" 
        type="url" 
        default="http://www.example.com" 
        label="Enter a URL" 
        description="" 
        size="10"
/>

url 规则和 url 输入过滤器都可以帮助确保在此字段中输入有效的 url 数据。

另请参阅

• 文本表单字段类型