@tower1229/flow-ui/modules/raty/raty.js

Highly customizable UI framework based Seajs/jQuery

/*
 * name:raty
 * version: 0.1.0
 * update: min
 * date: 2015-08-13
 * author  : Washington Botelho
 * doc     : http://wbotelhos.com/raty
 */
define('raty', function(require, exports, module) {
  var $ = window.$ || require('jquery');
  var imgfolder = require.resolve('./') + 'images/';
  seajs.importStyle('.cancel-on-png,.cancel-off-png,.star-on-png,.star-off-png,.star-half-png{font-size:2em}@font-face{font-family:"raty";font-style:normal;font-weight:normal;src:url("fonts/raty.eot");src:url("fonts/raty.eot?#iefix") format("embedded-opentype");src:url("fonts/raty.svg#raty") format("svg");src:url("fonts/raty.ttf") format("truetype");src:url("fonts/raty.woff") format("woff")}.cancel-on-png,.cancel-off-png,.star-on-png,.star-off-png,.star-half-png{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:"raty";font-style:normal;font-variant:normal;font-weight:normal;line-height:1;speak:none;text-transform:none}.cancel-on-png:before{content:"\\e600"}.cancel-off-png:before{content:"\\e601"}.star-on-png:before{content:"\\f005"}.star-off-png:before{content:"\\f006"}.star-half-png:before{content:"\\f123"}'
    ,module.uri);

  var methods={init:function(options){return this.each(function(){this.self=$(this);methods.destroy.call(this.self);this.opt=$.extend(true,{},$.fn.raty.defaults,options);methods._adjustCallback.call(this);methods._adjustNumber.call(this);methods._adjustHints.call(this);this.opt.score=methods._adjustedScore.call(this,this.opt.score);if(this.opt.starType!=='img'){methods._adjustStarType.call(this)}methods._adjustPath.call(this);methods._createStars.call(this);if(this.opt.cancel){methods._createCancel.call(this)}if(this.opt.precision){methods._adjustPrecision.call(this)}methods._createScore.call(this);methods._apply.call(this,this.opt.score);methods._setTitle.call(this,this.opt.score);methods._target.call(this,this.opt.score);if(this.opt.readOnly){methods._lock.call(this)}else{this.style.cursor='pointer';methods._binds.call(this)}})},_adjustCallback:function(){var options=['number','readOnly','score','scoreName','target'];for(var i=0;i<options.length;i++){if(typeof this.opt[options[i]]==='function'){this.opt[options[i]]=this.opt[options[i]].call(this)}}},_adjustedScore:function(score){if(!score){return score}return methods._between(score,0,this.opt.number)},_adjustHints:function(){if(!this.opt.hints){this.opt.hints=[]}if(!this.opt.halfShow&&!this.opt.half){return}var steps=this.opt.precision?10:2;for(var i=0;i<this.opt.number;i++){var group=this.opt.hints[i];if(Object.prototype.toString.call(group)!=='[object Array]'){group=[group]}this.opt.hints[i]=[];for(var j=0;j<steps;j++){var hint=group[j],last=group[group.length-1];if(last===undefined){last=null}this.opt.hints[i][j]=hint===undefined?last:hint}}},_adjustNumber:function(){this.opt.number=methods._between(this.opt.number,1,this.opt.numberMax)},_adjustPath:function(){this.opt.path=this.opt.path||'';if(this.opt.path&&this.opt.path.charAt(this.opt.path.length-1)!=='/'){this.opt.path+='/'}},_adjustPrecision:function(){this.opt.half=true},_adjustStarType:function(){var replaces=['cancelOff','cancelOn','starHalf','starOff','starOn'];this.opt.path='';for(var i=0;i<replaces.length;i++){this.opt[replaces[i]]=this.opt[replaces[i]].replace('.','-')}},_apply:function(score){methods._fill.call(this,score);if(score){if(score>0){this.score.val(score)}methods._roundStars.call(this,score)}},_between:function(value,min,max){return Math.min(Math.max(parseFloat(value),min),max)},_binds:function(){if(this.cancel){methods._bindOverCancel.call(this);methods._bindClickCancel.call(this);methods._bindOutCancel.call(this)}methods._bindOver.call(this);methods._bindClick.call(this);methods._bindOut.call(this)},_bindClick:function(){var that=this;that.stars.on('click.raty',function(evt){var execute=true,score=(that.opt.half||that.opt.precision)?that.self.data('score'):(this.alt||$(this).data('alt'));if(that.opt.click){execute=that.opt.click.call(that,+score,evt)}if(execute||execute===undefined){if(that.opt.half&&!that.opt.precision){score=methods._roundHalfScore.call(that,score)}methods._apply.call(that,score)}})},_bindClickCancel:function(){var that=this;that.cancel.on('click.raty',function(evt){that.score.removeAttr('value');if(that.opt.click){that.opt.click.call(that,null,evt)}})},_bindOut:function(){var that=this;that.self.on('mouseleave.raty',function(evt){var score=+that.score.val()||undefined;methods._apply.call(that,score);methods._target.call(that,score,evt);methods._resetTitle.call(that);if(that.opt.mouseout){that.opt.mouseout.call(that,score,evt)}})},_bindOutCancel:function(){var that=this;that.cancel.on('mouseleave.raty',function(evt){var icon=that.opt.cancelOff;if(that.opt.starType!=='img'){icon=that.opt.cancelClass+' '+icon}methods._setIcon.call(that,this,icon);if(that.opt.mouseout){var score=+that.score.val()||undefined;that.opt.mouseout.call(that,score,evt)}})},_bindOver:function(){var that=this,action=that.opt.half?'mousemove.raty':'mouseover.raty';that.stars.on(action,function(evt){var score=methods._getScoreByPosition.call(that,evt,this);methods._fill.call(that,score);if(that.opt.half){methods._roundStars.call(that,score,evt);methods._setTitle.call(that,score,evt);that.self.data('score',score)}methods._target.call(that,score,evt);if(that.opt.mouseover){that.opt.mouseover.call(that,score,evt)}})},_bindOverCancel:function(){var that=this;that.cancel.on('mouseover.raty',function(evt){var starOff=that.opt.path+that.opt.starOff,icon=that.opt.cancelOn;if(that.opt.starType==='img'){that.stars.attr('src',starOff)}else{icon=that.opt.cancelClass+' '+icon;that.stars.attr('class',starOff)}methods._setIcon.call(that,this,icon);methods._target.call(that,null,evt);if(that.opt.mouseover){that.opt.mouseover.call(that,null)}})},_buildScoreField:function(){return $('<input />',{name:this.opt.scoreName,type:'hidden'}).appendTo(this)},_createCancel:function(){var icon=this.opt.path+this.opt.cancelOff,cancel=$('<'+this.opt.starType+' />',{title:this.opt.cancelHint,'class':this.opt.cancelClass});if(this.opt.starType==='img'){cancel.attr({src:icon,alt:'x'})}else{cancel.attr('data-alt','x').addClass(icon)}if(this.opt.cancelPlace==='left'){this.self.prepend('&#160;').prepend(cancel)}else{this.self.append('&#160;').append(cancel)}this.cancel=cancel},_createScore:function(){var score=$(this.opt.targetScore);this.score=score.length?score:methods._buildScoreField.call(this)},_createStars:function(){for(var i=1;i<=this.opt.number;i++){var name=methods._nameForIndex.call(this,i),attrs={alt:i,src:this.opt.path+this.opt[name]};if(this.opt.starType!=='img'){attrs={'data-alt':i,'class':attrs.src}}attrs.title=methods._getHint.call(this,i);$('<'+this.opt.starType+' />',attrs).appendTo(this);if(this.opt.space){this.self.append(i<this.opt.number?'&#160;':'')}}this.stars=this.self.children(this.opt.starType)},_error:function(message){$(this).text(message);$.error(message)},_fill:function(score){var hash=0;for(var i=1;i<=this.stars.length;i++){var icon,star=this.stars[i-1],turnOn=methods._turnOn.call(this,i,score);if(this.opt.iconRange&&this.opt.iconRange.length>hash){var irange=this.opt.iconRange[hash];icon=methods._getRangeIcon.call(this,irange,turnOn);if(i<=irange.range){methods._setIcon.call(this,star,icon)}if(i===irange.range){hash++}}else{icon=this.opt[turnOn?'starOn':'starOff'];methods._setIcon.call(this,star,icon)}}},_getFirstDecimal:function(number){var decimal=number.toString().split('.')[1],result=0;if(decimal){result=parseInt(decimal.charAt(0),10);if(decimal.slice(1,5)==='9999'){result++}}return result},_getRangeIcon:function(irange,turnOn){return turnOn?irange.on||this.opt.starOn:irange.off||this.opt.starOff},_getScoreByPosition:function(evt,icon){var score=parseInt(icon.alt||icon.getAttribute('data-alt'),10);if(this.opt.half){var size=methods._getWidth.call(this),percent=parseFloat((evt.pageX-$(icon).offset().left)/size);score=score-1+percent}return score},_getHint:function(score,evt){if(score!==0&&!score){return this.opt.noRatedMsg}var decimal=methods._getFirstDecimal.call(this,score),integer=Math.ceil(score),group=this.opt.hints[(integer||1)-1],hint=group,set=!evt||this.move;if(this.opt.precision){if(set){decimal=decimal===0?9:decimal-1}hint=group[decimal]}else if(this.opt.halfShow||this.opt.half){decimal=set&&decimal===0?1:decimal>5?1:0;hint=group[decimal]}return hint===''?'':hint||score},_getWidth:function(){var width=this.stars[0].width||parseFloat(this.stars.eq(0).css('font-size'));if(!width){methods._error.call(this,'Could not get the icon width!')}return width},_lock:function(){var hint=methods._getHint.call(this,this.score.val());this.style.cursor='';this.title=hint;this.score.prop('readonly',true);this.stars.prop('title',hint);if(this.cancel){this.cancel.hide()}this.self.data('readonly',true)},_nameForIndex:function(i){return this.opt.score&&this.opt.score>=i?'starOn':'starOff'},_resetTitle:function(star){for(var i=0;i<this.opt.number;i++){this.stars[i].title=methods._getHint.call(this,i+1)}},_roundHalfScore:function(score){var integer=parseInt(score,10),decimal=methods._getFirstDecimal.call(this,score);if(decimal!==0){decimal=decimal>5?1:0.5}return integer+decimal},_roundStars:function(score,evt){var decimal=(score%1).toFixed(2),name;if(evt||this.move){name=decimal>0.5?'starOn':'starHalf'}else if(decimal>this.opt.round.down){name='starOn';if(this.opt.halfShow&&decimal<this.opt.round.up){name='starHalf'}else if(decimal<this.opt.round.full){name='starOff'}}if(name){var icon=this.opt[name],star=this.stars[Math.ceil(score)-1];methods._setIcon.call(this,star,icon)}},_setIcon:function(star,icon){star[this.opt.starType==='img'?'src':'className']=this.opt.path+icon},_setTarget:function(target,score){if(score){score=this.opt.targetFormat.toString().replace('{score}',score)}if(target.is(':input')){target.val(score)}else{target.html(score)}},_setTitle:function(score,evt){if(score){var integer=parseInt(Math.ceil(score),10),star=this.stars[integer-1];star.title=methods._getHint.call(this,score,evt)}},_target:function(score,evt){if(this.opt.target){var target=$(this.opt.target);if(!target.length){methods._error.call(this,'Target selector invalid or missing!')}var mouseover=evt&&evt.type==='mouseover';if(score===undefined){score=this.opt.targetText}else if(score===null){score=mouseover?this.opt.cancelHint:this.opt.targetText}else{if(this.opt.targetType==='hint'){score=methods._getHint.call(this,score,evt)}else if(this.opt.precision){score=parseFloat(score).toFixed(1)}var mousemove=evt&&evt.type==='mousemove';if(!mouseover&&!mousemove&&!this.opt.targetKeep){score=this.opt.targetText}}methods._setTarget.call(this,target,score)}},_turnOn:function(i,score){return this.opt.single?(i===score):(i<=score)},_unlock:function(){this.style.cursor='pointer';this.removeAttribute('title');this.score.removeAttr('readonly');this.self.data('readonly',false);for(var i=0;i<this.opt.number;i++){this.stars[i].title=methods._getHint.call(this,i+1)}if(this.cancel){this.cancel.css('display','')}},cancel:function(click){return this.each(function(){var self=$(this);if(self.data('readonly')!==true){methods[click?'click':'score'].call(self,null);this.score.removeAttr('value')}})},click:function(score){return this.each(function(){if($(this).data('readonly')!==true){score=methods._adjustedScore.call(this,score);methods._apply.call(this,score);if(this.opt.click){this.opt.click.call(this,score,$.Event('click'))}methods._target.call(this,score)}})},destroy:function(){return this.each(function(){var self=$(this),raw=self.data('raw');if(raw){self.off('.raty').empty().css({cursor:raw.style.cursor}).removeData('readonly')}else{self.data('raw',self.clone()[0])}})},getScore:function(){var score=[],value;this.each(function(){value=this.score.val();score.push(value?+value:undefined)});return(score.length>1)?score:score[0]},move:function(score){return this.each(function(){var integer=parseInt(score,10),decimal=methods._getFirstDecimal.call(this,score);if(integer>=this.opt.number){integer=this.opt.number-1;decimal=10}var width=methods._getWidth.call(this),steps=width/10,star=$(this.stars[integer]),percent=star.offset().left+steps*decimal,evt=$.Event('mousemove',{pageX:percent});this.move=true;star.trigger(evt);this.move=false})},readOnly:function(readonly){return this.each(function(){var self=$(this);if(self.data('readonly')!==readonly){if(readonly){self.off('.raty').children('img').off('.raty');methods._lock.call(this)}else{methods._binds.call(this);methods._unlock.call(this)}self.data('readonly',readonly)}})},reload:function(){return methods.set.call(this,{})},score:function(){var self=$(this);return arguments.length?methods.setScore.apply(self,arguments):methods.getScore.call(self)},set:function(options){return this.each(function(){$(this).raty($.extend({},this.opt,options))})},setScore:function(score){return this.each(function(){if($(this).data('readonly')!==true){score=methods._adjustedScore.call(this,score);methods._apply.call(this,score);methods._target.call(this,score)}})}};

  $.fn.raty = function(method) {
    if (methods[method]) {
      return methods[method].apply(this, Array.prototype.slice.call(arguments, 1));
    } else if (typeof method === 'object' || !method) {
      return methods.init.apply(this, arguments);
    } else {
      $.error('Method ' + method + ' does not exist!');
    }
  };

  $.fn.raty.defaults = {
    cancel       : false,
    cancelClass  : 'raty-cancel',
    cancelHint   : 'Cancel this rating!',
    cancelOff    : imgfolder+'cancel-off.png',
    cancelOn     : imgfolder+'cancel-on.png',
    cancelPlace  : 'left',
    click        : undefined,
    half         : false,
    halfShow     : true,
    hints        : ['bad', 'poor', 'regular', 'good', 'gorgeous'],
    iconRange    : undefined,
    mouseout     : undefined,
    mouseover    : undefined,
    noRatedMsg   : 'Not rated yet!',
    number       : 5,
    numberMax    : 20,
    path         : undefined,
    precision    : false,
    readOnly     : false,
    round        : { down: 0.25, full: 0.6, up: 0.76 },
    score        : undefined,
    scoreName    : 'score',
    single       : false,
    space        : true,
    starHalf     : imgfolder+'star-half.png',
    starOff      : imgfolder+'star-off.png',
    starOn       : imgfolder+'star-on.png',
    starType     : 'img',
    target       : undefined,
    targetFormat : '{score}',
    targetKeep   : false,
    targetScore  : undefined,
    targetText   : '',
    targetType   : 'hint'
  };

});