Merge pull request #378 from creocoder/jui-datepicker

[READY] jQuery UI DatePicker widget

framework/yii/jui/DatePicker.php

@@ -0,0 +1,99 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\jui;
+
+use Yii;
+use yii\helpers\Html;
+
+/**
+ * DatePicker renders an datepicker jQuery UI widget.
+ *
+ * For example:
+ *
+ * ```php
+ * echo DatePicker::widget(array(
+ *     'language' => 'ru',
+ *     'model' => $model,
+ *     'attribute' => 'country',
+ *     'clientOptions' => array(
+ *         'dateFormat' => 'yy-mm-dd',
+ *     ),
+ * ));
+ * ```
+ *
+ * The following example will use the name property instead:
+ *
+ * ```php
+ * echo DatePicker::widget(array(
+ *     'language' => 'ru',
+ *     'name'  => 'country',
+ *     'clientOptions' => array(
+ *         'dateFormat' => 'yy-mm-dd',
+ *     ),
+ * ));
+ *```
+ *
+ * @see http://api.jqueryui.com/datepicker/
+ * @author Alexander Kochetov <creocoder@gmail.com>
+ * @since 2.0
+ */
+class DatePicker extends InputWidget
+{
+	/**
+	 * @var string the locale ID (eg 'fr', 'de') for the language to be used by the date picker.
+	 * If this property set to false, I18N will not be involved. That is, the date picker will show in English.
+	 */
+	public $language = false;
+	/**
+	 * @var boolean If true, shows the widget as an inline calendar and the input as a hidden field.
+	 */
+	public $inline = false;
+
+
+	/**
+	 * Renders the widget.
+	 */
+	public function run()
+	{
+		echo $this->renderWidget() . "\n";
+		$this->registerWidget('datepicker');
+		if ($this->language !== false) {
+			$this->getView()->registerAssetBundle("yii/jui/datepicker/i18n/$this->language");
+		}
+	}
+
+	/**
+	 * Renders the DatePicker widget.
+	 * @return string the rendering result.
+	 */
+	protected function renderWidget()
+	{
+		$contents = array();
+
+		if ($this->inline === false) {
+			if ($this->hasModel()) {
+				$contents[] = Html::activeTextInput($this->model, $this->attribute, $this->options);
+			} else {
+				$contents[] = Html::textInput($this->name, $this->value, $this->options);
+			}
+		} else {
+			if ($this->hasModel()) {
+				$contents[] = Html::activeHiddenInput($this->model, $this->attribute, $this->options);
+				$this->clientOptions['defaultDate'] = $this->model->{$this->attribute};
+			} else {
+				$contents[] = Html::hiddenInput($this->name, $this->value, $this->options);
+				$this->clientOptions['defaultDate'] = $this->value;
+			}
+			$this->clientOptions['altField'] = '#' . $this->options['id'];
+			$this->options['id'] .= '-container';
+			$contents[] = Html::tag('div', null, $this->options);
+		}
+
+		return implode("\n", $contents);
+	}
+}

framework/yii/jui/InputWidget.php

@@ -0,0 +1,59 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\jui;
+
+use Yii;
+use yii\base\Model;
+use yii\base\InvalidConfigException;
+
+/**
+ * InputWidget is the base class for all jQuery UI input widgets.
+ *
+ * @author Alexander Kochetov <creocoder@gmail.com>
+ * @since 2.0
+ */
+class InputWidget extends Widget
+{
+	/**
+	 * @var Model the data model that this widget is associated with.
+	 */
+	public $model;
+	/**
+	 * @var string the model attribute that this widget is associated with.
+	 */
+	public $attribute;
+	/**
+	 * @var string the input name. This must be set if [[model]] and [[attribute]] are not set.
+	 */
+	public $name;
+	/**
+	 * @var string the input value.
+	 */
+	public $value;
+
+
+	/**
+	 * Initializes the widget.
+	 * If you override this method, make sure you call the parent implementation first.
+	 */
+	public function init()
+	{
+		if (!$this->hasModel() && $this->name === null) {
+			throw new InvalidConfigException("Either 'name' or 'model' and 'attribute' properties must be specified.");
+		}
+		parent::init();
+	}
+
+	/**
+	 * @return boolean whether this widget is associated with a data model.
+	 */
+	protected function hasModel()
+	{
+		return $this->model instanceof Model && $this->attribute !== null;
+	}
+}