README

渲染一个 Bootstrap 日期选择器插件。

安装

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

运行以下命令：

$ composer require 2amigos/yii2-date-picker-widget:~1.0

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

"2amigos/yii2-date-picker-widget" : "~1.0"

...

使用方法

此小部件有两种类型：

• DatePicker
• DateRangePicker

DatePicker

此小部件渲染一个 Bootstrap 日期选择器输入控件。最适合具有日期字符串属性的模型。

表单中使用示例
有两种方式使用它，使用 ActiveForm 实例或作为小部件设置其 model 和 attribute。

<?php
use dosamigos\datepicker\DatePicker;

// as a widget
?>

<?= DatePicker::widget([
    'model' => $model,
    'attribute' => 'date',
    'template' => '{addon}{input}',
        'clientOptions' => [
            'autoclose' => true,
            'format' => 'dd-M-yyyy'
        ]
]);?>

<?php 
// with an ActiveForm instance 
?>
<?= $form->field($model, 'date')->widget(
    DatePicker::className(), [
        // inline too, not bad
         'inline' => true, 
         // modify template for custom rendering
        'template' => '<div class="well well-sm" style="background-color: #fff; width:250px">{input}</div>',
        'clientOptions' => [
            'autoclose' => true,
            'format' => 'dd-M-yyyy'
        ]
]);?>

无模型使用示例

<?php
use dosamigos\datepicker\DatePicker;
?>
<?= DatePicker::widget([
    'name' => 'Test',
    'value' => '02-16-2012',
    'template' => '{addon}{input}',
        'clientOptions' => [
            'autoclose' => true,
            'format' => 'dd-M-yyyy'
        ]
]);?>

DateRangePicker

此小部件渲染一个 Bootstrap 日期范围选择器输入控件。

表单中使用示例
以下示例使用一个具有名为 date_from 和 date_to 的两个属性的模型。

<?php
use dosamigos\datepicker\DateRangePicker;
?>
<?= $form->field($tour, 'date_from')->widget(DateRangePicker::className(), [
    'attributeTo' => 'date_to', 
    'form' => $form, // best for correct client validation
    'language' => 'es',
    'size' => 'lg',
    'clientOptions' => [
        'autoclose' => true,
        'format' => 'dd-M-yyyy'
    ]
]);?>

无模型使用示例

<?php
use dosamigos\datepicker\DateRangePicker;
?>
<?= DateRangePicker::widget([
    'name' => 'date_from',
    'value' => '02-16-2012',
    'nameTo' => 'name_to',
    'valueTo' => '02-20-2012'
]);?>

测试

要测试此扩展，最好在您的计算机上克隆此仓库。之后，转到扩展文件夹并执行以下操作（假设您已经在计算机上安装了 composer）：

$ composer install --no-interaction --prefer-source --dev

一旦安装了所有必需的库，然后执行：

$ vendor/bin/phpunit

我建议全局安装 phpunit 和 xdebug，以便您还可以进行代码覆盖率分析。

更多信息

有关其配置选项的更多信息，请参阅 Bootstrap 日期选择器网站 文档。

贡献

有关详细信息，请参阅 CONTRIBUTING。

鸣谢

• Antonio Ramirez
• 所有贡献者

许可

BSD 许可证 (BSD)。有关更多信息，请参阅 许可文件。

Web 开发从未如此有趣！
www.2amigos.us