bui.rating Class
Constructor
bui.rating
(
-
option
Parameters:
-
optionObject-
idString控件id
-
[uid]String optional1.6.6新增，实例的自定义唯一名字，用于命令式调用
-
[handle]String optional点击的区域,属于循环的那部分
-
[half]Boolean optional是否支持半颗星
-
[clickFull]Boolean optional1.7.0新增 第一次点击是先半颗星还是1颗星，默认true（1颗星） | false(半颗星)
-
[stars]Number optional显示多少颗星星
-
[value]Number optional初始化多少颗星星
-
[show]Number optional展示多少颗星星比如 3.6 最后一颗星星会转换成60%
-
[disabled]Boolean optional是否只读
-
[render]Boolean optionaltrue | false 默认true,这样无需填写复杂的结构
-
[onBeforeInit]Function optional1.5.1新增 初始化前触发
-
[onInited]Function optional1.5.1新增 初始化以后触发
-
[onChange]Function optional1.6.0 每次改变才触发
-
[callback]Function optional点击按钮的回调
-
Example:
html:
<div id="rating" class="bui-rating"></div>
js:
// 初始化
var uiRating = bui.rating({
id:'#rating'
});
//获取值
uiRating.value();
Item Index
Methods
destroy
(
-
[bool]
[销毁控件]
Parameters:
-
[bool]Boolean optional默认: false 销毁部分 | true 销毁全部
Example:
//销毁
uiRating.destroy();
disabled
()
chainable
禁止评分
Example:
//禁止评分
uiRating.disabled();
enabled
()
chainable
允许评分
Example:
//允许评分
uiRating.enabled();
init
(
chainable
-
[option]
初始化方法,用于重新初始化结构,事件只初始化一次
Parameters:
-
[option]Object optional参数控件本身
option
(
chainable
-
[key] -
[value]
获取设置参数
Parameters:
-
[key]String | object optional不传则获取所有参数, 类型为string,没有第2个参数则获取某个参数
-
[value]String | number | boolean | function optional设置参数的时候要传,设置多个参数不用传,获取参数的时候也不用传
Example:
//获取所有参数
//获取所有参数
var option = uiRating.option();
//获取某个参数
var id = uiRating.option( "id" );
//修改一个参数
uiRating.option( "half",false );
//修改多个参数
uiRating.option( {"half":false} );
reset
()
重置
Example:
//重置
uiRating.reset();
show
(
chainable
-
[num]
展示评分的星星值,只读,支持星星的百分比展示
Parameters:
-
[num]String optional设置值
Example:
//设置值
uiRating.show(3);
value
(
-
[num]
设置｜获取星星的值
Parameters:
-
[num]Number optional设置值
Example:
//设置值
uiRating.value(3);
//获取值
var val = uiRating.value();
values
()
获取星星的值
Example:
//获取值
var val = uiRating.values();
widget
(
-
[name]
获取依赖的控件
Parameters:
-
[name]String optional依赖控件名
Example:
//获取依赖控件
var uiRatingWidget = uiRating.widget();
Events
off
为控件取消绑定事件
Event Payload:
-
[type]String optional事件类型: "change"
-
[callback]Function optional绑定的事件, this 为当前点击的菜单
Example:
uiRating.off("show");
on
为控件绑定事件
Event Payload:
-
[type]String optional事件类型: "change"
-
[callback]Function optional绑定的事件, this 为当前点击的菜单
Example:
uiRating.on("show",function () {
// 点击的菜单
console.log(this);
});