nex/yii2-datepicker

Bootstrap 3 Date/time picker widget for Yii2

dev-master 2018-01-30 04:44 UTC

Requires

• bower-asset/eonasdan-bootstrap-datetimepicker: 4.17.*
• bower-asset/moment: *
• yiisoft/yii2: *
• yiisoft/yii2-bootstrap: *

BSD-3-Clause

• Roman Ovchinnikov

• bootstrap
• extension
• widget
• datepicker
• yii2
• DateTimePicker

README

Credits

Jonathan Peterson (@Eonasdan) for Bootstrap 3 Date/Time Picker.

Antonio Ramirez (@tonydspaniard) for inspiration by Bootstrap DatePicker Widget for Yii2 and code examples.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require "nex/yii2-datepicker" "*"

or add

"nex/yii2-datepicker": "*"

to the require section of your application's composer.json file.

Usage

Please refer to the Datepicker documentation web page for options and examples of using Eonasdan's Datepicker widget.

To use widget as date/time picker, set appropriate format, e.g. 'L LT' (as in examples below). See momentjs' docs for valid formats.

With a model

<?php
use nex\datepicker\DatePicker;
?>

<?= DatePicker::widget([
    'model' => $model,
    'attribute' => 'attrName',
    'language' => 'ru',
    'size' => 'lg',
    'readonly' => true,
    'placeholder' => 'Choose date',
    'clientOptions' => [
        'format' => 'L',
        'minDate' => '2015-08-10',
        'maxDate' => '2015-09-10',
    ],
    'clientEvents' => [
        'dp.show' => new \yii\web\JsExpression("function () { console.log('It works!'); }"),
    ],
]);?>

<?= $form->field($model, 'attrName')->widget(
    DatePicker::className(), [
        'addon' => false,
        'size' => 'sm',
        'clientOptions' => [
            'format' => 'L LT',
            'stepping' => 30,
        ],
]);?>

Without a model

<?php
use nex\datepicker\DatePicker;
?>
<?= DatePicker::widget([
    'name' => 'datepickerTest',
    'value' => '09/13/2015',
    'clientOptions' => [
        'format' => 'L',
    ],
    'dropdownItems' => [
        ['label' => 'Yesterday', 'url' => '#', 'value' => \Yii::$app->formatter->asDate('-1 day')],
        ['label' => 'Tomorrow', 'url' => '#', 'value' => \Yii::$app->formatter->asDate('+1 day')],
        ['label' => 'Some value', 'url' => '#', 'value' => 'Special value'],
    ],
]);?>