README

okcoker/taggle.js 的 Yii2 小部件

安装

安装此扩展的首选方法是通过 composer。

运行以下命令之一

php composer.phar require --prefer-dist appage/yii2-taggle "*"

或将以下内容添加到您的 composer.json 文件的 require 部分。

"appage/yii2-taggle": "*"

使用方法

扩展安装后，只需在代码中使用即可

<?= \appage\taggle\widgets\TagsWidget::widget([
    'clientOptions' => [
        'tags' => ['These', 'are', 'prefilled', 'tags'],
    ],
    'name' => 'example[]',
]) ?>

或与模型一起使用： (将两个块合并在一起)

// If tags list empty, this will save empty array
<?= $form->field($model, 'tagsList')->hiddenInput([
    'name' => $model->formName() . '[tagsList][]',
    'value' => '',
])->label(false) ?>

// If not empty - this will add tags
<?= $form->field($model, 'tagsList[]')->widget(\appage\taggle\widgets\TagsWidget::className(), [
    'clientOptions' => [
        'hiddenInputName' => $model->formName() . '[tagsList][]',
        'tags' => ($model->tagsList ? $model->tagsList : []),
    ],
]) ?>

如果您将标签列表存储为以逗号分隔的字符串，则可以使用我们的模型行为

public function behaviors()
{
    return [
        'tagsList' => [
            'class' => 'appage\taggle\behaviors\TagsBehavior',
            'owner' => $this,
        ],
    ];
}

并为 tagsList 添加 安全 规则

注意：不要忘记添加 $hiddenInputName 参数

要显示标签，可以使用 TagsListWidget

echo TagsListWidget::widget([
    'tagsList' => $model->tagsList,
]);

有关更多信息，请参阅 okcoker/taggle.js 文档。