CJuiSliderInput

优质
小牛编辑
125浏览
2023-12-01
所有包 | 属性 | 方法
zii.widgets.jui
继承class CJuiSliderInput » CJuiInputWidget » CJuiWidget » CWidget » CBaseController » CComponent
源自1.1
版本$Id: CJuiSliderInput.php 2948 2011-02-09 13:27:05Z haertl.mike $
源码framework/zii/widgets/jui/CJuiSliderInput.php
CJuiSliderInput显示一个滑块。它能用在表单中并post它的值。

CJuiSlider封装了JUI slider插件。

使用这个部件,你可以在视图里面插入以下代码:
$this->widget('zii.widgets.jui.CJuiSliderInput', array(  'name'=>'rate',  'value'=>37,  // additional javascript options for the slider plugin  'options'=>array(      'min'=>10,      'max'=>50,  ),  'htmlOptions'=>array(      'style'=>'height:20px;'  ),
));


这个部件也可使用范围内的模式,它使用2滑块来设置范围。 在这种模式中,attribute和maxAttribute将定义最大和最小范围值。 例如:

$this->widget('zii.widgets.jui.CJuiSliderInput', array(  'model'=>$model,  'attribute'=>'timeMin',  'maxAttribute'=>'timeMax,  // additional javascript options for the slider plugin  'options'=>array(      'range'=>true,      'min'=>0,      'max'=>24,  ),
));


如果你需要使用slider事件,请改变事件值为‘stop’或‘change’。

通过配置options属性, 你可以指定需要传递给JUI slider插件的选项。 如果需要选择(name-value pairs), 请参阅JUI slider说明。

公共属性

隐藏继承属性

属性类型描述定义在
actionPrefixstringactions的ID的前缀。 当微件在CController::actions中声明了 动作提供者,可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时,必须配置同样的前缀。CWidget
attributestring和这个小物件相关的属性。 这个名称可能包含中括号(例如‘name[1]’),用于搜集表格式的数据输入。CJuiInputWidget
controllerCController返回此微件所属的控制器。CWidget
cssFilemixed主题的CSS文件名。默认是‘jquery-ui.CJuiWidget
eventstring事件的名称,这里input被附加到slider。 它可能是‘slide’,‘stop’或‘change’。如果你想使用‘slide’事件,改变$event属性到‘change’。CJuiSliderInput
htmlOptionsarrayJUI组件中HTML标签的属性设置。CJuiWidget
idstring返回此微件的ID。如果需要的话,将生产一个新的ID并将其返回。CWidget
maxAttributestring如果slider被用在range模式,属性名的最大值。CJuiSliderInput
modelCModel与这个小物件相关的数据模型CJuiInputWidget
namestring输入框名称。如果model没有设置,这个必须设置。CJuiInputWidget
optionsarraythe 初始的JavaScript需要传递给JUI插件的选项。CJuiWidget
ownerCBaseController返回此微件的所有者或创建者。CWidget
scriptFilemixed主要JUI的JavaScript的文件名。默认是‘jquery-ui.CJuiWidget
scriptUrlstring包含所有JUI JavaScript文件的根目录。 如果没有设置这个属性(默认),Yii will publish the JUI package included in the zii release and use that to infer the root script URL.CJuiWidget
skinmixed微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false,微件将不会有皮肤被使用。CWidget
tagNamestring包含slider的容器元素名称。默认是‘div’。CJuiSliderInput
themestringJUI主题的名字。默认是‘base’。确保在themeUrl下有这样一个目录, 其名称是这个属性的值相同(区分大小写)。CJuiWidget
themeUrlstring包含所有JUI的主题文件夹的根目录。 如果没有设置这个属性(默认), Yii will publish the JUI package included in the zii release and use that to infer the root theme URL.CJuiWidget
valueinteger确定slider的值,如果仅有一个事件处理程序。如果超过一个事件处理程序,确定第一个事件处理程序的值。CJuiSliderInput
viewPathstring返回包含此微件所需的视图文件的路径。CWidget

公共方法

隐藏继承方法

方法描述定义在
__call()如果类中没有调的方法名,则调用这个方法。CComponent
__construct()构造器。CWidget
__get()返回一个属性值、一个事件处理程序列表或一个行为名称。CComponent
__isset()检查一个属性是否为null。CComponent
__set()设置一个组件的属性值。CComponent
__unset()设置一个组件的属性为null。CComponent
actions()返回此widget使用的动作的列表。CWidget
asa()返回这个名字的行为对象。CComponent
attachBehavior()附加一个行为到组件。CComponent
attachBehaviors()附加一个行为列表到组件。CComponent
attachEventHandler()为事件附加一个事件处理程序。CComponent
beginCache()Begins fragment caching.CBaseController
beginClip()Begins recording a clip.CBaseController
beginContent()Begins the rendering of content that is to be decorated by the specified view.CBaseController
beginWidget()Creates a widget and executes it.CBaseController
canGetProperty()确定属性是否可读。CComponent
canSetProperty()确定属性是否可写。CComponent
createWidget()Creates a widget and initializes it.CBaseController
detachBehavior()从组件中分离一个行为。CComponent
detachBehaviors()从组件中分离所有行为。CComponent
detachEventHandler()分离一个存在的事件处理程序。CComponent
disableBehavior()禁用一个附加行为。CComponent
disableBehaviors()禁用组件附加的所有行为。CComponent
enableBehavior()启用一个附加行为。CComponent
enableBehaviors()启用组件附加的所有行为。CComponent
endCache()Ends fragment caching.CBaseController
endClip()Ends recording a clip.CBaseController
endContent()Ends the rendering of content.CBaseController
endWidget()Ends the execution of the named widget.CBaseController
evaluateExpression()计算一个PHP表达式,或根据组件上下文执行回调。CComponent
getController()返回此微件所属的控制器。CWidget
getEventHandlers()返回一个事件的附加处理程序列表。CComponent
getId()返回此微件的ID。如果需要的话,将生产一个新的ID并将其返回。CWidget
getOwner()返回此微件的所有者或创建者。CWidget
getViewFile()根据视图名查找视图文件。CWidget
getViewPath()返回包含此微件所需的视图文件的路径。CWidget
hasEvent()确定一个事件是否定义。CComponent
hasEventHandler()检查事件是否有附加的处理程序。CComponent
hasProperty()确定属性是否被定义。CComponent
init()初始化这个组件。CJuiWidget
raiseEvent()发起一个事件。CComponent
render()渲染一个视图。CWidget
renderFile()Renders a view file.CBaseController
renderInternal()Renders a view file.CBaseController
run()运行这个部件。CJuiSliderInput
setId()设置此微件的ID。CWidget
widget()Creates a widget and executes it.CBaseController

受保护方法

隐藏继承方法

方法描述定义在
hasModel()确定是否这个小物件与一个数据模型相关。CJuiInputWidget
registerCoreScripts()注册核心的脚本文件。CJuiWidget
registerScriptFile()注册一个JavaScript文件在scriptUrl下。CJuiWidget
resolveNameID()CJuiInputWidget
resolvePackagePath()确定JUI包安装路径。CJuiWidget

属性详细

event 属性 public string $event;

事件的名称,这里input被附加到slider。 它可能是‘slide’,‘stop’或‘change’。如果你想使用‘slide’事件,改变$event属性到‘change’。

maxAttribute 属性 public string $maxAttribute;

如果slider被用在range模式,属性名的最大值。

tagName 属性 public string $tagName;

包含slider的容器元素名称。默认是‘div’。

value 属性 public integer $value;

确定slider的值,如果仅有一个事件处理程序。如果超过一个事件处理程序,确定第一个事件处理程序的值。

方法详细

run() 方法
public void run()
源码: framework/zii/widgets/jui/CJuiSliderInput.php#90 (显示) publicfunctionrun()
{
list($name,$id)=$this->resolveNameID();

$isRange=isset($this->options['range'])&&$this->options['range'];

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->hasModel())
{
$attribute=$this->attribute;
if($isRange)
{
$options=$this->htmlOptions;
echoCHtml::activeHiddenField($this->model,$this->attribute,$options);
$options['id']=$options['id'].'_end';
echoCHtml::activeHiddenField($this->model,$this->maxAttribute,$options);
$attrMax=$this->maxAttribute;
$this->options['values']=array($this->model->$attribute,$this->model->$attrMax);
}
else
{
echoCHtml::activeHiddenField($this->model,$this->attribute,$this->htmlOptions);
$this->options['value']=$this->model->$attribute;
}
}
else
{
echoCHtml::hiddenField($name,$this->value,$this->htmlOptions);
if($this->value!==null)
$this->options['value']=$this->value;
}


$idHidden=$this->htmlOptions['id'];
$nameHidden=$name;

$this->htmlOptions['id']=$idHidden.'_slider';
$this->htmlOptions['name']=$nameHidden.'_slider';

echoCHtml::openTag($this->tagName,$this->htmlOptions);
echoCHtml::closeTag($this->tagName);

$this->options[$this->event]=$isRange?
"js:function(e,ui){v=ui.values;jQuery('#{$idHidden}').val(v[0]);jQuery('#{$idHidden}_end').val(v[1]);}":
'js:function(event,ui){jQuery('#'.$idHidden.'').val(ui.value);}';

$options=empty($this->options)?'':CJavaScript::encode($this->options);

$js="jQuery('#{$id}_slider').slider($options);n";
Yii::app()->getClientScript()->registerScript(__CLASS__.'#'.$id,$js);
}

运行这个部件。 这个方法注册必要的javascript并渲染相应的HTML代码。