/*! * jQuery Raty - A Star Rating Plugin * * The MIT License * * @author : Washington Botelho * @doc : http://wbotelhos.com/raty * @version : 2.7.0 * */ ; (function($) { 'use strict'; 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 $('', { 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 { // TODO: use $.data cancel.attr('data-alt', 'x').addClass(icon); } if (this.opt.cancelPlace === 'left') { this.self.prepend(' ').prepend(cancel); } else { this.self.append(' ').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 }; // TODO: use $.data. } attrs.title = methods._getHint.call(this, i); $('<' + this.opt.starType + ' />', attrs).appendTo(this); if (this.opt.space) { this.self.append(i < this.opt.number ? ' ' : ''); } } 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) { // Up: [x.76 .. x.99] name = 'starOn'; if (this.opt.halfShow && decimal < this.opt.round.up) { // Half: [x.26 .. x.75] name = 'starHalf'; } else if (decimal < this.opt.round.full) { // Down: [x.00 .. x.5] name = 'starOff'; } } if (name) { var icon = this.opt[name], star = this.stars[Math.ceil(score) - 1]; methods._setIcon.call(this, star, icon); } // Full down: [x.00 .. x.25] }, _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 : 'cancel-off.png', cancelOn : '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 : 'star-half.png', starOff : 'star-off.png', starOn : 'star-on.png', starType : 'img', target : undefined, targetFormat : '{score}', targetKeep : false, targetScore : undefined, targetText : '', targetType : 'hint' }; })(jQuery);