Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/daxslab/yii2-selectize-widget
Selectize From Brian Reavis Yii2 Widget
https://github.com/daxslab/yii2-selectize-widget
Last synced: 3 days ago
JSON representation
Selectize From Brian Reavis Yii2 Widget
- Host: GitHub
- URL: https://github.com/daxslab/yii2-selectize-widget
- Owner: daxslab
- License: other
- Fork: true (2amigos/yii2-selectize-widget)
- Created: 2022-03-20T23:03:22.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2022-03-20T23:04:27.000Z (over 2 years ago)
- Last Synced: 2024-07-06T17:44:17.012Z (3 months ago)
- Language: PHP
- Size: 119 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Selectize JS Widget for Yii2
[](https://github.com/2amigos/yii2-selectize-widget/tags)
[](LICENSE.md)
[](https://travis-ci.org/2amigos/yii2-selectize-widget)
[](https://scrutinizer-ci.com/g/2amigos/yii2-selectize-widget/code-structure)
[](https://scrutinizer-ci.com/g/2amigos/yii2-selectize-widget)
[](https://packagist.org/packages/2amigos/yii2-selectize-widget)
[Selectize](https://selectize.github.io/selectize.js/) is an extensible jQuery-based custom <select> UI control. It's useful for tagging, contact lists, country selectors, and so on. It clocks in at around ~7kb (gzipped). The goal is to provide a solid & usable experience with a clean and powerful API.
## Installation
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```bash
$ composer require 2amigos/yii2-selectize-widget:~1.0
```
or add
```
"2amigos/yii2-selectize-widget": "~1.0"
```
to the `require` section of your `composer.json` file.
## Usage
Selectize has lots of configuration options. For further information, please check the Selectize plugin [website](https://selectize.github.io/selectize.js/).
### Text input widget
To use text input widget add the following to the view
```php
use dosamigos\selectize\SelectizeTextInput;
echo SelectizeTextInput::widget([
'name' => 'tags',
'value' => 'love, this, game',
'clientOptions' => [
// ...
],
]);
```
### Dropdown list widget
To use dropdown list widget add the following to the view
```php
use dosamigos\selectize\SelectizeDropDownList;
echo SelectizeDropDownList::widget([
'name' => 'tags',
'items' => ['love', 'this', 'game'],
'clientOptions' => [
// ...
],
]);
```
## Configuration
SelectizeDropDownList extends from [InputWidget](http://www.yiiframework.com/doc-2.0/yii-widgets-inputwidget.html), but have additional properties that can be configured.
|Property|Type|Default|Description
|-|-|-|-|
|`loadUrl`|string|array|null|Optional. This parameter will be passed to [Url::to](http://www.yiiframework.com/doc-2.0/guide-runtime-routing.html). If set, selectize plugin will be configured to send ajax requests to the defined url to retrieve options. Url must return a valid JSON response. |
|`queryParam`|string|'query'|The name of the request parameter to use on ajax requests|
|`clientOptions`|array|null|Configuration of selectize plugin. This configuration is individual for each selectize instance.|
## Testing
```bash
$ ./vendor/bin/phpunit
```
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Credits
- [Antonio Ramirez](https://github.com/tonydspaniard)
- [All Contributors](https://github.com/2amigos/yii2-selectize-widget/graphs/contributors)
## License
The BSD License (BSD). Please see [License File](LICENSE.md) for more information.
web development has never been so fun
www.2amigos.us