Yii2 TagsInput
Tags input widget for Yii2
Requirements
- PHP 5.6 or higher
- Yii2 v.2.0.33 and newest
- Yii2 Bootstrap
- Bootstrap TagsInput
Installation
To install the widget, run the following command in the console:
$ composer require "wdmg/yii2-tagsinput"
Usage
Example of standalone widget:
<?php
use wdmg\widgets\TagsInput;
...
echo TagsInput::widget([
'model' => $model,
'attribute' => 'post_tags',
'options' => [
'class' => 'form-control'
],
'pluginOptions' => [
'minInput' => 2,
'maxTags' => 100
]
]);
?>
Example of use with ActiveForm:
<?php
use wdmg\widgets\TagsInput;
...
$form = ActiveForm::begin();
...
echo $form->field($model, 'tags')->widget(TagsInput::class, [
'options' => [
'id' => 'post-tags',
'class' => 'form-control',
'placeholder' => 'Type your tags here...'
],
'pluginOptions' => [
'autocomplete' => '//example.com/api/',
'format' => 'json',
'minInput' => 2,
'maxTags' => 100
]
]);
...
ActiveForm::end();
?>
Options
TagsInput extends InputWidget so you can use any options available for this widget. In addition, you can use these custom options if necessary:
| Name | Type | Default | Description |
|---|---|---|---|
| options | array | ['class' => 'form-control'] |
Standard options for the input widget. |
| pluginOptions | array | array() | Plugin TagsInput options passed to js. Read more here (https://github.com/wdmg/bootstrap-tagsinput). |
| items | array | ['value' => 'Label'] |
Array values with labels. |
Status and version [ready to use]
- v.1.0.4 - Fixed widget ID and init after Pjax reloading
- v.1.0.3 - Up to date dependencies
- v.1.0.2 - Fixed deprecated class declaration and added README.md
