Subversion Repositories Integrator Subversion

/*! RateIt | v1.0.18 / 12/22/2013 | https://rateit.codeplex.com/license

    http://rateit.codeplex.com | Twitter: @gjunge

*/

(function ($) {

    $.rateit = {

        aria : {

            resetLabel: 'reset rating',

            ratingLabel: 'rating'

        }

    }

    $.fn.rateit = function (p1, p2) {

        //quick way out.

        var index = 1;

        var options = {}; var mode = 'init';

        var capitaliseFirstLetter = function (string) {

            return string.charAt(0).toUpperCase() + string.substr(1);

        };

        if (this.length == 0) return this;

        var tp1 = $.type(p1);

        if (tp1 == 'object' || p1 === undefined || p1 == null) {

            options = $.extend({}, $.fn.rateit.defaults, p1); //wants to init new rateit plugin(s).

        }

        else if (tp1 == 'string' && p1 !== 'reset' && p2 === undefined) {

            return this.data('rateit' + capitaliseFirstLetter(p1)); //wants to get a value.

        }

        else if (tp1 == 'string') {

            mode = 'setvalue'

        }

        return this.each(function () {

            var item = $(this);

            //shorten all the item.data('rateit-XXX'), will save space in closure compiler, will be like item.data('XXX') will become x('XXX')

            var itemdata = function (key, value) {

                if (value != null) {

                    //update aria values

                    var ariakey = 'aria-value' + ((key == 'value') ? 'now' : key);

                    var range = item.find('.rateit-range');

                    if (range.attr(ariakey) != undefined) {

                        range.attr(ariakey, value);

                    }

                }

                arguments[0] = 'rateit' + capitaliseFirstLetter(key);

                return item.data.apply(item, arguments); ////Fix for WI: 523

            };

            //handle programmatic reset

            if (p1 == 'reset') {

              var setup = itemdata('init'); //get initial value

              for (var prop in setup) {

                item.data(prop, setup[prop]);

              }

              if (itemdata('backingfld')) { //reset also backingfield

                var fld = $(itemdata('backingfld'));

                fld.val(itemdata('value'));

                if (fld[0].min) fld[0].min = itemdata('min');

                if (fld[0].max) fld[0].max = itemdata('max');

                if (fld[0].step) fld[0].step = itemdata('step');

              }

              item.trigger('reset');

            }

            //add the rate it class.

            if (!item.hasClass('rateit')) item.addClass('rateit');

            var ltr = item.css('direction') != 'rtl';

            // set value mode

            if (mode == 'setvalue') {

                if (!itemdata('init')) throw 'Can\'t set value before init';

                //if readonly now and it wasn't readonly, remove the eventhandlers.

                if (p1 == 'readonly' && p2 == true && !itemdata('readonly')) {

                    item.find('.rateit-range').unbind();

                    itemdata('wired', false);

                }

                //when we receive a null value, reset the score to its min value.

                if (p1 == 'value')

                    p2 = (p2 == null) ? itemdata('min') : Math.max(itemdata('min'), Math.min(itemdata('max'), p2));

                if (itemdata('backingfld')) {

                    //if we have a backing field, check which fields we should update. 

                    //In case of input[type=range], although we did read its attributes even in browsers that don't support it (using fld.attr())

                    //we only update it in browser that support it (&& fld[0].min only works in supporting browsers), not only does it save us from checking if it is range input type, it also is unnecessary.

                    var fld = $(itemdata('backingfld'));

                    if (p1 == 'value') fld.val(p2);

                    if (p1 == 'min' && fld[0].min) fld[0].min = p2;

                    if (p1 == 'max' && fld[0].max) fld[0].max = p2;

                    if (p1 == 'step' && fld[0].step) fld[0].step = p2;

                }

                itemdata(p1, p2);

            }

            //init rateit plugin

            if (!itemdata('init')) {

                //get our values, either from the data-* html5 attribute or from the options.

                itemdata('min', isNaN(itemdata('min')) ? options.min : itemdata('min'));

                itemdata('max', isNaN(itemdata('max')) ? options.max : itemdata('max'));

                itemdata('step', itemdata('step') || options.step);

                itemdata('readonly', itemdata('readonly') !== undefined ? itemdata('readonly') : options.readonly);

                itemdata('resetable', itemdata('resetable') !== undefined ? itemdata('resetable') : options.resetable);

                itemdata('backingfld', itemdata('backingfld') || options.backingfld);

                itemdata('starwidth', itemdata('starwidth') || options.starwidth);

                itemdata('starheight', itemdata('starheight') || options.starheight);

                itemdata('value', Math.max(itemdata('min'), Math.min(itemdata('max'), (!isNaN(itemdata('value')) ? itemdata('value') : (!isNaN(options.value) ? options.value : options.min) ))));

                itemdata('ispreset', itemdata('ispreset') !== undefined ? itemdata('ispreset') : options.ispreset);

                //are we LTR or RTL?

                if (itemdata('backingfld')) {

                    //if we have a backing field, hide it, and get its value, and override defaults if range.

                    var fld = $(itemdata('backingfld'));

                    itemdata('value', fld.hide().val());

                    if (fld.attr('disabled') || fld.attr('readonly'))

                        itemdata('readonly', true); //http://rateit.codeplex.com/discussions/362055 , if a backing field is disabled or readonly at instantiation, make rateit readonly.

                    if (fld[0].nodeName == 'INPUT') {

                        if (fld[0].type == 'range' || fld[0].type == 'text') { //in browsers not support the range type, it defaults to text

                            itemdata('min', parseInt(fld.attr('min')) || itemdata('min')); //if we would have done fld[0].min it wouldn't have worked in browsers not supporting the range type.

                            itemdata('max', parseInt(fld.attr('max')) || itemdata('max'));

                            itemdata('step', parseInt(fld.attr('step')) || itemdata('step'));

                        }

                    }

                    if (fld[0].nodeName == 'SELECT' && fld[0].options.length > 1) {

                        itemdata('min', Number(fld[0].options[0].value));

                        itemdata('max', Number(fld[0].options[fld[0].length - 1].value));

                        itemdata('step', Number(fld[0].options[1].value) - Number(fld[0].options[0].value));

                    }

                }

                //Create the necessary tags. For ARIA purposes we need to give the items an ID. So we use an internal index to create unique ids

                var element = item[0].nodeName == 'DIV' ? 'div' : 'span';

                index++;

                var html = '<button id="rateit-reset-{{index}}" data-role="none" class="rateit-reset" aria-label="' + $.rateit.aria.resetLabel + '" aria-controls="rateit-range-{{index}}"></button><{{element}} id="rateit-range-{{index}}" class="rateit-range" tabindex="0" role="slider" aria-label="' + $.rateit.aria.ratingLabel + '" aria-owns="rateit-reset-{{index}}" aria-valuemin="' + itemdata('min') + '" aria-valuemax="' + itemdata('max') + '" aria-valuenow="' + itemdata('value') + '"><{{element}} class="rateit-selected" style="height:' + itemdata('starheight') + 'px"></{{element}}><{{element}} class="rateit-hover" style="height:' + itemdata('starheight') + 'px"></{{element}}></{{element}}>';

                item.append(html.replace(/{{index}}/gi, index).replace(/{{element}}/gi, element));

                //if we are in RTL mode, we have to change the float of the "reset button"

                if (!ltr) {

                    item.find('.rateit-reset').css('float', 'right');

                    item.find('.rateit-selected').addClass('rateit-selected-rtl');

                    item.find('.rateit-hover').addClass('rateit-hover-rtl');

                }

                itemdata('init', JSON.parse(JSON.stringify(item.data()))); //cheap way to create a clone

            }

            //resize the height of all elements, 

            item.find('.rateit-selected, .rateit-hover').height(itemdata('starheight'));

            //set the range element to fit all the stars.

            var range = item.find('.rateit-range');

            range.width(itemdata('starwidth') * (itemdata('max') - itemdata('min'))).height(itemdata('starheight'));

            //add/remove the preset class

            var presetclass = 'rateit-preset' + ((ltr) ? '' : '-rtl');

            if (itemdata('ispreset'))

                item.find('.rateit-selected').addClass(presetclass);

            else

                item.find('.rateit-selected').removeClass(presetclass);

            //set the value if we have it.

            if (itemdata('value') != null) {

                var score = (itemdata('value') - itemdata('min')) * itemdata('starwidth');

                item.find('.rateit-selected').width(score);

            }

            //setup the reset button

            var resetbtn = item.find('.rateit-reset');

            if (resetbtn.data('wired') !== true) {

                resetbtn.bind('click', function (e) {

                    e.preventDefault();

                    resetbtn.blur();

                    item.rateit('value', null);

                    item.trigger('reset');

                }).data('wired', true);

            }

            //this function calculates the score based on the current position of the mouse.

            var calcRawScore = function (element, event) {

                var pageX = (event.changedTouches) ? event.changedTouches[0].pageX : event.pageX;

                var offsetx = pageX - $(element).offset().left;

                if (!ltr) offsetx = range.width() - offsetx;

                if (offsetx > range.width()) offsetx = range.width();

                if (offsetx < 0) offsetx = 0;

                return score = Math.ceil(offsetx / itemdata('starwidth') * (1 / itemdata('step')));

            };

            //sets the hover element based on the score.

            var setHover = function (score) {

                var w = score * itemdata('starwidth') * itemdata('step');

                var h = range.find('.rateit-hover');

                if (h.data('width') != w) {

                    range.find('.rateit-selected').hide();

                    h.width(w).show().data('width', w);

                    var data = [(score * itemdata('step')) + itemdata('min')];

                    item.trigger('hover', data).trigger('over', data);

                }

            };

            var setSelection = function (value) {

                itemdata('value', value);

                if (itemdata('backingfld')) {

                    $(itemdata('backingfld')).val(value);

                }

                if (itemdata('ispreset')) { //if it was a preset value, unset that.

                    range.find('.rateit-selected').removeClass(presetclass);

                    itemdata('ispreset', false);

                }

                range.find('.rateit-hover').hide();

                range.find('.rateit-selected').width(value * itemdata('starwidth') - (itemdata('min') * itemdata('starwidth'))).show();

                item.trigger('hover', [null]).trigger('over', [null]).trigger('rated', [value]);

            };

            if (!itemdata('readonly')) {

                //if we are not read only, add all the events

                //if we have a reset button, set the event handler.

                if (!itemdata('resetable'))

                    resetbtn.hide();

                //when the mouse goes over the range element, we set the "hover" stars.

                if (!itemdata('wired')) {

                    range.bind('touchmove touchend', touchHandler); //bind touch events

                    range.mousemove(function (e) {

                        var score = calcRawScore(this, e);

                        setHover(score);

                    });

                    //when the mouse leaves the range, we have to hide the hover stars, and show the current value.

                    range.mouseleave(function (e) {

                        range.find('.rateit-hover').hide().width(0).data('width', '');

                        item.trigger('hover', [null]).trigger('over', [null]);

                        range.find('.rateit-selected').show();

                    });

                    //when we click on the range, we have to set the value, hide the hover.

                    range.mouseup(function (e) {

                        var score = calcRawScore(this, e);

                        var value = (score * itemdata('step')) + itemdata('min');

                        setSelection(value);

                        range.blur();

                    });

                    //support key nav

                    range.keyup( function (e) {

                        if (e.which == 38 || e.which == (ltr ? 39 : 37)) {

                            setSelection(Math.min(itemdata('value') + itemdata('step'), itemdata('max')));

                        }

                        if (e.which == 40 || e.which == (ltr ? 37 : 39)) {

                            setSelection(Math.max(itemdata('value') - itemdata('step'), itemdata('min')));

                        }

                    });

                    itemdata('wired', true);

                }

                if (itemdata('resetable')) {

                    resetbtn.show();

                }

            }

            else {

                resetbtn.hide();

            }

            range.attr('aria-readonly', itemdata('readonly'));

        });

    };

    //touch converter http://ross.posterous.com/2008/08/19/iphone-touch-events-in-javascript/

    function touchHandler(event) {

        var touches = event.originalEvent.changedTouches,

                first = touches[0],

                type = "";

        switch (event.type) {

            case "touchmove": type = "mousemove"; break;

            case "touchend": type = "mouseup"; break;

            default: return;

        }

        var simulatedEvent = document.createEvent("MouseEvent");

        simulatedEvent.initMouseEvent(type, true, true, window, 1,

                              first.screenX, first.screenY,

                              first.clientX, first.clientY, false,

                              false, false, false, 0/*left*/, null);

        first.target.dispatchEvent(simulatedEvent);

        event.preventDefault();

    };

    //some default values.

    $.fn.rateit.defaults = { min: 0, max: 5, step: 0.5, starwidth: 16, starheight: 16, readonly: false, resetable: true, ispreset: false};

    //invoke it on all .rateit elements. This could be removed if not wanted.

    $(function () { $('div.rateit, span.rateit').rateit(); });

})(jQuery);