154 lines
6.4 KiB
Markdown
154 lines
6.4 KiB
Markdown
# jQuery Raty - A Star Rating Plugin - http://wbotelhos.com/raty
|
|
|
|
### 2.1.0
|
|
|
|
+ Now Raty keeps the state of the elements and no longer depends on ID for each one:
|
|
+ The score no longer has ID;
|
|
+ The stars images no longer has ID;
|
|
+ The stars images no longer has class.
|
|
+ Added function 'score' to recover the current score.
|
|
|
|
### 2.0.0
|
|
|
|
+ Added option 'halfShow' to just display and separate from the option to vote 'half';
|
|
+ Added option 'targetText' to choose default value when there is no score or targetKepp is off.
|
|
+ Added option 'precision' to be able rating with precision values, without star representation;
|
|
+ Added option 'space' to be able take off the spaces between the star;
|
|
+ Added option 'round' to customize the visual rounding of values;
|
|
+ Added option 'targetFormat' to customize the target with a template;
|
|
+ Added option 'single' to present only the selected star; (suggestion by newcube)
|
|
+ Fixed bug in IE 7 that returns void instead undefined when there is no an attribute;
|
|
+ Fixed bug that not set custom width when 'readOnly' is enabled;
|
|
+ Fixed bug that not set back the hints after disable read only option;
|
|
+ Fixed bug that not create cancel button when starts with 'readOnly';
|
|
+ Fixed the function cancel() to set the right hint on target score;
|
|
+ Fixed the functions start() and click() to set the value on target when 'target' option is enabled;
|
|
+ Fixed the functions start() and click() not to be executed when 'readOnly' is enabled;
|
|
+ Fixed the 'target' option to work with 'half' and 'precision' option;
|
|
+ Fixed the index number given to Raty binded by class without id; (by "Remember me, please?")
|
|
+ Refactored the code to make it cleanner and faster;
|
|
+ Changed the class of the cancel button to 'raty-cancel' to avoid CSS conflicts;
|
|
+ Now is possible to use 'start' option as callback function to get start value; (by hpgihan)
|
|
+ Now the scope of click callback is the raty element as DOM, not jQuery selection, to follow the usual;
|
|
+ Now the field score is set to readonly when 'readOnly' is enabled.
|
|
+ Now attribute 'iconRange' is represented as a list of object with option to choose starOn and starOff;
|
|
+ Now we using the best pratice to build the plugin;
|
|
+ Now the plugin is under test with Jasmine and Jasmine jQuery.
|
|
|
|
### 1.4.3
|
|
|
|
+ Now public function return the context to be able the chaining;
|
|
+ Fixed: the option 'readOnly' brokes the plugin;
|
|
+ Prevented the processing of the set of classes in public function.
|
|
|
|
### 1.4.0
|
|
|
|
+ Added attribute 'target' to choose a element to display the score when the mouse is on the star;
|
|
+ Added attribute 'targetKeep' to keep the selected value on the target element;
|
|
+ Added attribute 'targetType' to choose what display in the target element: hint or number;
|
|
+ New function called $.fn.raty.cancel() to cancel the rating;
|
|
+ Now the action of cancel removes the score value instead set it to zero;
|
|
+ Using mouseover when the half star is disabled to avoid to waste actions trigger;
|
|
+ Now is possible pass a empty string in the $.fn.raty.start() to cancel the rating;
|
|
+ Public functions without specify ID or class is no longer supported.
|
|
|
|
### 1.3.3
|
|
|
|
+ Fixed the icon presentation when the start attribute is setted and the iconRange is enabled;
|
|
+ Now the click function receives the event as argument. (by Eric Wendelin)
|
|
|
|
### 1.3.2
|
|
|
|
+ Fixed: the last Raty configuration will not be applied in others targets Raty anymore;
|
|
+ Now is possible to use the element as identifier like div.star on direct actions.
|
|
|
|
### 1.3.0
|
|
|
|
+ Added attribute size for to choose the size of the icons that will be used;
|
|
+ Added attribute width for to choose the container width of the stars;
|
|
+ Changed the name of the attribute showCancel to just cancel.
|
|
|
|
### 1.2.1
|
|
|
|
+ Fixed half star when click function is enabled.
|
|
|
|
### 1.2.0
|
|
|
|
+ Added support to half star selection;
|
|
+ Changed the name of the attribute onClick to just click;
|
|
+ Changed the name of the attribute showHalf to half, because of the selection support.
|
|
|
|
### 1.0.1
|
|
|
|
+ Fixed the ID's auto generation to work in IE6 and IE7.
|
|
|
|
### 1.0.0
|
|
|
|
+ Now you can pass a optionally ID or a class to be the target of the public function's actions;
|
|
+ Fixed the read-only that wasn't begin applied by the public function readOnly.
|
|
|
|
### 0.9
|
|
|
|
+ Improved the selector to accept bind by class name;
|
|
+ Now if you don't pass a ID for the element, then it will be created;
|
|
+ Now the hint list will be applied even if the quantity are less than the stars.
|
|
|
|
### 0.8
|
|
|
|
+ Added iconRange attribute. Now you can set custom icons for especific ranges;
|
|
+ Fixed the cancel button that didn't hidden when using the public function readOnly.
|
|
|
|
### 0.7
|
|
|
|
+ Added noRatedMsg attribute. A hint for no rated elements when it's read-only;
|
|
+ Avoided negative star number in public function start;
|
|
+ Avoided a number bigger than the number of star in public function start;
|
|
+ Fixed the public function start when the star are read-only and is not passed a start value;
|
|
+ Fixed the half star function on it is made by public function start;
|
|
|
|
### 0.6
|
|
|
|
+ Now you can use the key "this" to refer the star element itself in the onClick handler;
|
|
+ Fixed the reference context when using public functions or local functions;
|
|
+ When the stars are read-only, all titles are transformed in the corresponding title score;
|
|
+ Avoided negative star number;
|
|
+ Avoided more than 20 stars. But it's can be changed in the script if you need.
|
|
|
|
### 0.5
|
|
|
|
+ Now you can put a cancel button to cancel your rating;
|
|
+ Choose the cancel image off;
|
|
+ Choose the cancel image on;
|
|
+ Choose the left or right side position for the cancel button;
|
|
+ Change the hint of the cancel button.
|
|
|
|
### 0.4
|
|
|
|
+ Added support to display half star.
|
|
|
|
### 0.3
|
|
|
|
+ Fixed some mistakes to work on IE browser.
|
|
|
|
### 0.2
|
|
|
|
+ Added the public function click, that do the click on a star;
|
|
+ Was removed the execution of the onClick when used the function start;
|
|
+ Added onClick function that enable a callback when a star is clicked.
|
|
|
|
### 0.1
|
|
|
|
+ Change the path of images;
|
|
+ Change the name image files;
|
|
+ Choose the number of stars that will be presented;
|
|
+ Choose a hint information of each star;
|
|
+ Start with a default score;
|
|
+ Set the stars read-only;
|
|
+ Choose the name of the hidden score field.
|
|
|
|
### known Bugs
|
|
|
|
+ On versions before 1.6 if a attribute not exists, then empty string is returned instead undefined;
|
|
+ On 1.5.2 the opt.click callback is never called, because this version always returns undefined to .call() and .apply();
|
|
+ On 1.5.2 the attribute readonly is setted with empty value as following readonly="".
|