README

👁 Image

JUI Extension for Yii 2

This is the JQuery UI extension for Yii framework 2.0. It encapsulates JQuery UI widgets as Yii widgets, and makes using JQuery UI widgets in Yii applications extremely easy.

For license information check the LICENSE-file.

Documentation is at docs/guide/README.md.

👁 Latest Stable Version
👁 Total Downloads
👁 Build Status
👁 codecov

Installation

Important

• The minimum required PHP version is PHP 7.4.
• It works best with PHP 8.

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist yiisoft/yii2-jui

or add

"yiisoft/yii2-jui": "~2.0.0"

to the require section of your composer.json file.

Usage

The following single line of code in a view file would render a JQuery UI DatePicker widget:

<?= yii\jui\DatePicker::widget(['name' => 'attributeName']) ?>

Configuring the Jquery UI options should be done using the clientOptions attribute:

<?= yii\jui\DatePicker::widget(['name' => 'attributeName', 'clientOptions' => ['defaultDate' => '2014-01-01']]) ?>

If you want to use the JUI widget in an ActiveForm, it can be done like this:

<?= $form->field($model,'attributeName')->widget(DatePicker::className(),['clientOptions' => ['defaultDate' => '2014-01-01']]) ?>