README

OctoberCMS 的标签表单小部件。

安装

要安装 Tagbox 小部件，请将以下内容添加到您的插件 composer.json 文件中。

"require": {
    "owl/tagbox": "~1.0@dev"
}

接下来，在您的插件 Plugin.php 文件中注册该小部件。

public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Tagbox\Widget' => [
            'label' => 'Tagbox',
            'code'  => 'owl-tagbox'
        ],
    ];
}

使用方法

要使用 Tagbox 小部件，只需将字段类型声明为 owl-tagbox

tags:
    label: Tags
    type: owl-tagbox

如果标签不是通过相关模型存储，则模型属性必须是可序列化的。如果标签是通过相关模型存储，则必须声明 getTagsAttribute 和 setTagsAttribute 方法以处理关系。这些方法应返回/接受一个字符串数组。

可以通过定义 validation 正则表达式参数对标签进行验证。还可以定义 validationMessage 以自定义错误消息。例如，如果您接受电子邮件数组，可以使用以下内容来验证 tagbox 的值...

emails:
    label: Email Addresses
    type: owl-tagbox
    validation: ^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
    validationMessage: Please enter a valid email address.

可以使用 filter 表达式来阻止不想要的字符。在以下示例中，我们将允许字母数字字符、破折号和下划线。默认 CSS 可以通过指定 cssPath 属性进行自定义或删除。

tags:
    label: Tags
    type: owl-tagbox
    filter: "[^a-zA-Z0-9_.-]+"
    cssPath: /plugins/vendor/plugin/assets/css/custom-tagbox.css

最后，可以通过将 slugify 参数设置为 true 来在输入时对标签进行“slugify”（生成短链接）。

owl / tagbox

维护者

详细信息

README

安装

使用方法