README

致谢

Jonathan Peterson (@Eonasdan) 为 Bootstrap 3 日期/时间选择器 贡献。

Antonio Ramirez (@tonydspaniard) 受 Bootstrap DatePicker Widget for Yii2 启发并提供了代码示例。

安装

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

运行以下命令之一：

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

或者将以下内容添加到您的应用程序的 composer.json 文件的 require 部分：

"nex/yii2-datepicker": "*"

使用方法

有关使用 Eonasdan 的 Datepicker 小部件的选项和示例，请参阅 Datepicker 文档 网页。

要使用小部件作为日期/时间选择器，请设置适当的格式，例如 'L LT'（如下面的示例所示）。有关有效格式的详细信息，请参阅 momentjs 文档。

与模型一起使用

<?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,
        ],
]);?>

不与模型一起使用

<?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'],
    ],
]);?>