Yii Framework v1.1.10 类参考
CJuiDatePicker
| 包 | zii.widgets.jui |
|---|---|
| 继承 | class CJuiDatePicker » CJuiInputWidget » CJuiWidget » CWidget » CBaseController » CComponent |
| 源自 | 1.1 |
| 版本 | $Id: CJuiDatePicker.php 3539 2012-01-15 18:55:01Z mdomba $ |
| 源码 | framework/zii/widgets/jui/CJuiDatePicker.php |
CJuiDatePicker显示一个日期选择器。
CJuiDatePicker封装了JUI datepicker插件。
使用这个部件，你可以在视图里面插入以下代码：
通过配置options属性， 你可以指定需要传递给JUI datepicker插件的选项。 如果需要选择（name-value pairs）， 请参阅JUI datepicker说明。
CJuiDatePicker封装了JUI datepicker插件。
使用这个部件，你可以在视图里面插入以下代码：
$this->widget('zii.widgets.jui.CJuiDatePicker', array(
'name'=>'publishDate',
// additional javascript options for the date picker plugin
'options'=>array(
'showAnim'=>'fold',
),
'htmlOptions'=>array(
'style'=>'height:20px;'
),
));
通过配置options属性， 你可以指定需要传递给JUI datepicker插件的选项。 如果需要选择（name-value pairs）， 请参阅JUI datepicker说明。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| actionPrefix | string | actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者，可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时，必须配置同样的前缀。 | CWidget |
| attribute | string | 和这个小物件相关的属性。 这个名称可能包含中括号（例如‘name[1]’），用于搜集表格式的数据输入。 | CJuiInputWidget |
| controller | CController | 返回此微件所属的控制器。 | CWidget |
| cssFile | mixed | 主题的CSS文件名。默认是‘jquery-ui. | CJuiWidget |
| defaultOptions | array | 默认选择就是一个时间段的每个请求。此选项将改变页面中的每个其他CJuiDatePicker实例。 它必须在第一次调用请求CJuiDatePicker部件设置。 | CJuiDatePicker |
| flat | boolean | 如果为true，显示为内嵌日历的部件和一个输入隐藏字段。使用onSelect事件，以更新的隐藏字段 | CJuiDatePicker |
| htmlOptions | array | JUI组件中HTML标签的属性设置。 | CJuiWidget |
| i18nScriptFile | string | i18n Jquery UI的脚本文件。它使用scriptUrl属性为base url。 | CJuiDatePicker |
| id | string | 返回此微件的ID。如果需要的话，将生产一个新的ID并将其返回。 | CWidget |
| language | string | 要使用的日期选择器的语言区域设置ID（如‘法语’，‘德语’）。 如果未设置此属性，I18N将不参与。就是说，日期选择器将显示为英文。 你可以强制设置英文语言属性设置为‘’（空字符） | CJuiDatePicker |
| model | CModel | 与这个小物件相关的数据模型 | CJuiInputWidget |
| name | string | 输入框名称。如果model没有设置，这个必须设置。 | CJuiInputWidget |
| options | array | the 初始的JavaScript需要传递给JUI插件的选项。 | CJuiWidget |
| owner | CBaseController | 返回此微件的所有者或创建者。 | CWidget |
| scriptFile | mixed | 主要JUI的JavaScript的文件名。默认是‘jquery-ui. | CJuiWidget |
| scriptUrl | string | 包含所有JUI JavaScript文件的根目录。 如果没有设置这个属性（默认），Yii will publish the JUI package included in the zii release and use that to infer the root script URL. | CJuiWidget |
| skin | mixed | 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false，微件将不会有皮肤被使用。 | CWidget |
| theme | string | JUI主题的名字。默认是‘base’。确保在themeUrl下有这样一个目录， 其名称是这个属性的值相同（区分大小写）。 | CJuiWidget |
| themeUrl | string | 包含所有JUI的主题文件夹的根目录。 如果没有设置这个属性（默认）， Yii will publish the JUI package included in the zii release and use that to infer the root theme URL. | CJuiWidget |
| value | string | 输入框的值 | CJuiInputWidget |
| viewPath | string | 返回包含此微件所需的视图文件的路径。 | CWidget |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| hasModel() | 确定是否这个小物件与一个数据模型相关。 | CJuiInputWidget |
| registerCoreScripts() | 注册核心的脚本文件。 | CJuiWidget |
| registerScriptFile() | 注册一个JavaScript文件在scriptUrl下。 | CJuiWidget |
| resolveNameID() | CJuiInputWidget | |
| resolvePackagePath() | 确定JUI包安装路径。 | CJuiWidget |
属性详细
defaultOptions
属性
public array $defaultOptions;
默认选择就是一个时间段的每个请求。此选项将改变页面中的每个其他CJuiDatePicker实例。 它必须在第一次调用请求CJuiDatePicker部件设置。
flat
属性
public boolean $flat;
如果为true，显示为内嵌日历的部件和一个输入隐藏字段。使用onSelect事件，以更新的隐藏字段
i18nScriptFile
属性
public string $i18nScriptFile;
i18n Jquery UI的脚本文件。它使用scriptUrl属性为base url。
language
属性
public string $language;
要使用的日期选择器的语言区域设置ID（如‘法语’，‘德语’）。 如果未设置此属性，I18N将不参与。就是说，日期选择器将显示为英文。 你可以强制设置英文语言属性设置为‘’（空字符）
方法详细
run()
方法
|
public void run()
|
源码： framework/zii/widgets/jui/CJuiDatePicker.php#72 (显示)
public function run()
{
list($name,$id)=$this->resolveNameID();
if(isset($this->htmlOptions['id']))
$id=$this->htmlOptions['id'];
else
$this->htmlOptions['id']=$id;
if(isset($this->htmlOptions['name']))
$name=$this->htmlOptions['name'];
if ($this->flat===false)
{
if($this->hasModel())
echo CHtml::activeTextField($this->model,$this->attribute,$this->htmlOptions);
else
echo CHtml::textField($name,$this->value,$this->htmlOptions);
}
else
{
if($this->hasModel())
{
echo CHtml::activeHiddenField($this->model,$this->attribute,$this->htmlOptions);
$attribute = $this->attribute;
$this->options['defaultDate'] = $this->model->$attribute;
}
else
{
echo CHtml::hiddenField($name,$this->value,$this->htmlOptions);
$this->options['defaultDate'] = $this->value;
}
if (!isset($this->options['onSelect']))
$this->options['onSelect']="js:function( selectedDate ) { jQuery('#{$id}').val(selectedDate);}";
$id = $this->htmlOptions['id'] = $id.'_container';
$this->htmlOptions['name'] = $name.'_container';
echo CHtml::tag('div', $this->htmlOptions, '');
}
$options=CJavaScript::encode($this->options);
$js = "jQuery('#{$id}').datepicker($options);";
if ($this->language!='' && $this->language!='en')
{
$this->registerScriptFile($this->i18nScriptFile);
$js = "jQuery('#{$id}').datepicker(jQuery.extend({showMonthAfterYear:false}, jQuery.datepicker.regional['{$this->language}'], {$options}));";
}
$cs = Yii::app()->getClientScript();
if (isset($this->defaultOptions))
{
$this->registerScriptFile($this->i18nScriptFile);
$cs->registerScript(__CLASS__, $this->defaultOptions!==null?'jQuery.datepicker.setDefaults('.CJavaScript::encode($this->defaultOptions).');':'');
}
$cs->registerScript(__CLASS__.'#'.$id, $js);
}
运行这个部件。 这个方法注册必要的javascript并渲染相应的HTML代码。