jQuery Raty - A Star Rating Plugin
Usage with Image
- jquery.raty.js
- star-off.png
- star-on.png
;
Usage with Font
- jquery.raty.js
- jquery.raty.[eot|svg|ttf|woff]
- jquery.raty.css
;
Options
cancel: false // Creates a cancel button to cancel the rating.cancelClass: 'raty-cancel' // Name of cancel's class.cancelHint: 'Cancel this rating!' // The cancel's button hint.cancelOff: 'cancel-off.png' // Icon used on active cancel.cancelOn: 'cancel-on.png' // Icon used inactive cancel.cancelPlace: 'left' // Cancel's button position.click: undefined // Callback executed on rating click.half: false // Enables half star selection.halfShow: true // Enables half star display.hints: 'bad' 'poor' 'regular' 'good' 'gorgeous' // Hints used on each star.iconRange: undefined // Object list with position and icon on and off to do a mixed icons.mouseout: undefined // Callback executed on mouseout.mouseover: undefined // Callback executed on mouseover.noRatedMsg: 'Not rated yet!' // Hint for no rated elements when it's readOnly.number: 5 // Number of stars that will be presented.numberMax: 20 // Max of star the option number can creates.path: undefined // A global locate where the icon will be looked.precision: false // Enables the selection of a precision score.readOnly: false // Turns the rating read-only.round: down: 25 full: 6 up: 76 // Included values attributes to do the score round math.score: undefined // Initial rating.scoreName: 'score' // Name of the hidden field that holds the score value.single: false // Enables just a single star selection.space: true // Puts space between the icons.starHalf: 'star-half.png' // The name of the half star image.starOff: 'star-off.png' // Name of the star image off.starOn: 'star-on.png' // Name of the star image on.target: undefined // Element selector where the score will be displayed.targetForma: '{score}' // Template to interpolate the score in.targetKeep: false // If the last rating value will be keeped after mouseout.targetScore: undefined // Element selector where the score will be filled, instead of creating a new hidden field (scoreName option).targetText: '' // Default text setted on target.targetType: 'hint' // Option to choose if target will receive hint o 'score' type.starType: 'img' // Element used to represent a star.
Functions
; // Get the current score. ; // Set the score. ; // Click on some star. ; // Change the read-only state. ; // Cancel the rating. The last param force the click callback. ; // Reload the rating with the current configuration. ; // Reset the rating with new configurations. ; // Destroy the bind and give you the raw element. ; // Move the mouse to the given score point position.