API Docs for: 0.2
Show:

JC.Rate Class

JC.Rate 星形评分组件

require: JC.BaseMVC

JC Project Site | API docs | demo link

页面只要引用本脚本, 默认会处理 [ span | label ] class="js_compRate"

可用的 HTML attribute

totalnum = int, default = 5
显示分数所用的总星星数量
maxscore = int, default = 5
最大分数上限,支持浮点数
minscore = int, default = 5
最小分数下限,支持浮点数
score = int, default = 0
默认分数
half = boolean, default = false
星星是否支持显示半颗星
cancel = boolean, default = false
是否需要清零按钮
hints = string, default = '较差,一般,不错,很好,非常棒'
鼠标hover时,显示的title,以分号隔开
hiddenName = string, default = 'score'
隐藏域控件的 name

Constructor

JC.Rate

(
  • _selector
)

Parameters:

Example:

  <h2>Title:</h2>
  <span class="js_compRate" score="3" hints="1分,2分,3分,4分,5分"></span>
  <h2>Click Callback:</h2>
  <span class="js_compRate js_rateClickedEvent" score="3">
      <input id="score-input" ReadOnly type="text" />
  </span>

Methods

_beforeInit

() private

初始化之前调用的方法

_init

(
  • _selector
)
private

内部初始化方法

Parameters:

  • _selector Selector

_inited

() private

内部初始化完毕时, 调用的方法

_initHanlderEvent

() private

内部事件初始化方法

init

(
  • _selector
)
Array of RateInstance static

初始化可识别的 Rate 实例

Parameters:

  • _selector Selector

Returns:

Array of RateInstance:

notification

(
  • _evtName
  • _args
)

通知选择器有新事件
JC 组件以后不会在 HTML 属性里放回调, 改为触发 selector 的事件

Parameters:

notificationHandler

(
  • _evtName
  • _args
)

通知选择器有新事件, 有返回结果
JC 组件以后不会在 HTML 属性里放回调, 改为触发 selector 的事件

Parameters:

Returns:

:

on

(
  • _evtName
  • _cb
)

使用 jquery on 绑定事件

Parameters:

Returns:

BaseMVCInstance

selector

()

获取 显示 BaseMVC 的触发源选择器, 比如 a 标签

Returns:

selector

trigger

(
  • _evtName
  • _args
)

使用 jquery trigger 触发绑定事件

Parameters:

Returns:

BaseMVCInstance

triggerHandler

(
  • _evtName
  • _args
)

使用 jquery triggerHandler 触发绑定事件

Parameters:

Returns:

:

Events

rateClicked

JC.Rate 点击后 selector 触发的事件 返回触发点击事件的元素

Event Payload:

  • _evt Event
  • _rateIns RateInstance

Example:

   $( document ).delegate( 'span.js_rateClickedEvent', 'rateClicked', function( _evt, _target, _rateIns ) {
        var star = _target;
       JC.log( 'rate clicked' );
   } );
   

rateInited

JC.Rate 初始化后 selector 触发的事件

Event Payload:

  • _evt Event
  • _rateIns RateInstance

Example:

   $( document ).delegate( 'span.js_rateInitedEvent', 'rateInited', function( _evt, _rateIns ){
       var _selector = $( this );
       JC.log( 'rateInited event' );
   });