DatePicker.php 7.31 KB
Newer Older
1 2 3 4 5 6 7 8 9
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\jui;

10
use Yii;
11
use yii\base\InvalidParamException;
12
use yii\helpers\FormatConverter;
13
use yii\helpers\Html;
14
use yii\helpers\Json;
15 16

/**
17
 * DatePicker renders a `datepicker` jQuery UI widget.
18
 *
19
 * For example to use the datepicker with a [[yii\base\Model|model]]:
20 21
 *
 * ```php
Alexander Makarov committed
22
 * echo DatePicker::widget([
23
 *     'model' => $model,
24
 *     'attribute' => 'from_date',
25 26
 *     //'language' => 'ru',
 *     //'dateFormat' => 'yyyy-MM-dd',
Alexander Makarov committed
27
 * ]);
28 29 30 31 32
 * ```
 *
 * The following example will use the name property instead:
 *
 * ```php
Alexander Makarov committed
33
 * echo DatePicker::widget([
34
 *     'name'  => 'from_date',
35 36 37
 *     'value'  => $value,
 *     //'language' => 'ru',
 *     //'dateFormat' => 'yyyy-MM-dd',
Alexander Makarov committed
38
 * ]);
39
 * ```
40
 *
41 42 43 44 45 46 47 48
 * Note that empty values like empty strings and 0 will result in a date displayed as `1970-01-01`.
 * So to make sure empty values result in an empty text field in the datepicker you need to add a
 * validation filter in your model that sets the value to `null` in case when no date has been entered:
 *
 * ```php
 * [['from_date'], 'default', 'value' => null],
 * ```
 *
49 50
 * @see http://api.jqueryui.com/datepicker/
 * @author Alexander Kochetov <creocoder@gmail.com>
51
 * @author Carsten Brandt <mail@cebe.cc>
52 53
 * @since 2.0
 */
Alexander Kochetov committed
54
class DatePicker extends InputWidget
55
{
56
    /**
57
     * @var string the locale ID (e.g. 'fr', 'de', 'en-GB') for the language to be used by the date picker.
58
     * If this property is empty, then the current application language will be used.
59 60 61
     *
     * Since version 2.0.2 a fallback is used if the application language includes a locale part (e.g. `de-DE`) and the language
     * file does not exist, it will fall back to using `de`.
62 63 64 65 66 67 68 69 70 71 72
     */
    public $language;
    /**
     * @var boolean If true, shows the widget as an inline calendar and the input as a hidden field.
     */
    public $inline = false;
    /**
     * @var array the HTML attributes for the container tag. This is only used when [[inline]] is true.
     * @see \yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.
     */
    public $containerOptions = [];
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
    /**
     * @var string the format string to be used for formatting the date value. This option will be used
     * to populate the [[clientOptions|clientOption]] `dateFormat`.
     * The value can be one of "short", "medium", "long", or "full", which represents a preset format of different lengths.
     *
     * It can also be a custom format as specified in the [ICU manual](http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Time-Format-Syntax).
     * Alternatively this can be a string prefixed with `php:` representing a format that can be recognized by the
     * PHP [date()](http://php.net/manual/de/function.date.php)-function.
     *
     * For example:
     *
     * ```php
     * 'MM/dd/yyyy' // date in ICU format
     * 'php:m/d/Y' // the same date in PHP format
     * ```
     *
     * If not set the default value will be taken from `Yii::$app->formatter->dateFormat`.
     */
    public $dateFormat;
    /**
     * @var string the model attribute that this widget is associated with.
     * The value of the attribute will be converted using [[\yii\i18n\Formatter::asDate()|`Yii::$app->formatter->asDate()`]]
     * with the [[dateFormat]] if it is not null.
     */
    public $attribute;
    /**
     * @var string the input value.
     * This value will be converted using [[\yii\i18n\Formatter::asDate()|`Yii::$app->formatter->asDate()`]]
     * with the [[dateFormat]] if it is not null.
     */
    public $value;
104

105

106 107 108 109 110 111 112 113 114
    /**
     * @inheritdoc
     */
    public function init()
    {
        parent::init();
        if ($this->inline && !isset($this->containerOptions['id'])) {
            $this->containerOptions['id'] = $this->options['id'] . '-container';
        }
115 116 117
        if ($this->dateFormat === null) {
            $this->dateFormat = Yii::$app->formatter->dateFormat;
        }
118
    }
119

120 121 122 123 124 125
    /**
     * Renders the widget.
     */
    public function run()
    {
        echo $this->renderWidget() . "\n";
Qiang Xue committed
126

127 128
        $containerID = $this->inline ? $this->containerOptions['id'] : $this->options['id'];
        $language = $this->language ? $this->language : Yii::$app->language;
Qiang Xue committed
129

130 131 132 133 134 135
        if (strncmp($this->dateFormat, 'php:', 4) === 0) {
            $this->clientOptions['dateFormat'] = FormatConverter::convertDatePhpToJui(substr($this->dateFormat, 4), 'date', $language);
        } else {
            $this->clientOptions['dateFormat'] = FormatConverter::convertDateIcuToJui($this->dateFormat, 'date', $language);
        }

136
        if ($language != 'en-US') {
137
            $view = $this->getView();
Qiang Xue committed
138 139
            $bundle = DatePickerLanguageAsset::register($view);
            if ($bundle->autoGenerate) {
140 141 142 143
                $fallbackLanguage = substr($language, 0, 2);
                if ($fallbackLanguage !== $language && !file_exists(Yii::getAlias($bundle->sourcePath . "/ui/i18n/datepicker-$language.js"))) {
                    $language = $fallbackLanguage;
                }
144
                $view->registerJsFile($bundle->baseUrl . "/ui/i18n/datepicker-$language.js", [
Qiang Xue committed
145 146 147
                    'depends' => [JuiAsset::className()],
                ]);
            }
148 149 150
            $options = Json::encode($this->clientOptions);
            $view->registerJs("$('#{$containerID}').datepicker($.extend({}, $.datepicker.regional['{$language}'], $options));");
        } else {
Qiang Xue committed
151
            $this->registerClientOptions('datepicker', $containerID);
152
        }
Qiang Xue committed
153 154 155

        $this->registerClientEvents('datepicker', $containerID);
        JuiAsset::register($this->getView());
156
    }
Qiang Xue committed
157

158 159 160 161 162 163 164
    /**
     * Renders the DatePicker widget.
     * @return string the rendering result.
     */
    protected function renderWidget()
    {
        $contents = [];
165

166 167 168 169 170 171 172
        // get formatted date value
        if ($this->hasModel()) {
            $value = Html::getAttributeValue($this->model, $this->attribute);
        } else {
            $value = $this->value;
        }
        if ($value !== null) {
173 174 175 176 177 178
            // format value according to dateFormat
            try {
                $value = Yii::$app->formatter->asDate($value, $this->dateFormat);
            } catch(InvalidParamException $e) {
                // ignore exception and keep original value if it is not a valid date
            }
179 180 181 182
        }
        $options = $this->options;
        $options['value'] = $value;

183
        if ($this->inline === false) {
184
            // render a text input
185
            if ($this->hasModel()) {
186
                $contents[] = Html::activeTextInput($this->model, $this->attribute, $options);
187
            } else {
188
                $contents[] = Html::textInput($this->name, $value, $options);
189 190
            }
        } else {
191
            // render an inline date picker with hidden input
192
            if ($this->hasModel()) {
193
                $contents[] = Html::activeHiddenInput($this->model, $this->attribute, $options);
194
            } else {
195
                $contents[] = Html::hiddenInput($this->name, $value, $options);
196
            }
197
            $this->clientOptions['defaultDate'] = $value;
198 199 200
            $this->clientOptions['altField'] = '#' . $this->options['id'];
            $contents[] = Html::tag('div', null, $this->containerOptions);
        }
Alexander Kochetov committed
201

202 203
        return implode("\n", $contents);
    }
204
}