rateThis
rateThis is a jquery plugin that allows you to easy create rating functionality for your form.
Browser Support
rateThis has been tested and should work in
- Internet Explorer 8+
- Safari
- Firefox
- Chrome
- Opera
Examples
You can find some examples here.
Usage
Include the code before </body>
tag
<script src="/path/to/rateThis.min.js"></script>
Then just add it to one of DOMs elements
<script>
$('#elementsID').rateThis();
</script>
API
Settable Options
Option | Description | Data Type | Default |
---|---|---|---|
fullImg | Name of image file to use for displaying current rating | string | 'full.png' |
emptyImg | Name of image file to use for displaying possible rating | string | 'empty.png' |
zero | If true, will display image to set value of rating to zero | boolean | false |
zeroImg | Name of image file to use for displaying zero rating | string | 'zero.png' |
value | Default value for rating | integer | 1 |
max | Max value for rating | integer | 5 |
hover | If true, will display image for highlighting current selected rating | boolean | true |
hoverImg | Name of image file to use for displaying for highlight | string | 'hover.png' |
disabled | If true, rating will be displayed as disabled | boolean | false |
disabledFullImg | Name of image file to use for displaying current rating when disabled | string | 'full.png' |
disabledEmptyImg | Name of image file to use for displaying possible rating when disabled | string | 'empty.png' |
disabledZeroImg | Name of image file to use for displaying zero rating when disabled | string | 'zero.png' |
Methods
Method | Description |
---|---|
disable | Disables the rating |
enable | Enables the rating |
update | Updates plugin view, for new input value |
uncheck | Unchecks the checkbox |
destroy | Removes plugin functionality |
License
rateThis plugin is released under MIT license.
Credits
rateThis plugin was created by MichaĆ Kowalkowski. You can contact me at kowalkowski.michal@gmail.com