123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762 |
- /*!
- * 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 $('<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 {
- // 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) {
- try {//ACE
- star[this.opt.starType === 'img' ? 'src' : 'className'] = this.opt.path + icon;
- } catch(e) {}
- },
- _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);
|