kartik-v/bootstrap-star-rating
A simple yet powerful JQuery star rating plugin with fractional rating support.
📋 Changes
- Simplify NPM module handling.
📋 Changes
- (enh #215): Correct NPM module handling.
📋 Changes
- (bug #213): Correct `mousenter` event to `mouseenter`.
- (enh #212): Enhance caption badge styles.
- (enh #211): Correct keyboard arrow keys behavior for RTL oriented inputs.
- (enh #210): Revamp themes - set default theme to Krajee SVG.
📋 Changes
- Correct `minThreshold` default value.
📋 Changes
- (enh #209): Enhancements to support BS 5.x (and 4.x/3.x).
📋 Changes
- (enh #208): Corrected positioning of the base input on which the rating is triggered.
- (enh #205): Add Dutch Translations.
- (enh #200): Activate Open Collective.
- (enh #199): Add Greek Translations.
- (enh #145): Minimum value threshold validation.
- New property `minThreshold` which allows a star rated with minimum value always. The initial value
- The `minThreshold` value must be a value between the `min` and `max` values
- If `minThreshold` is set to less than `min` the plugin will default `minThreshold` to the `min` value
- + 10 more
📋 Changes
- (enh #195): Update Bootstrap dependency.
- (enh #194, enh #180): Allow StarCaptionClasses CSS classes to also be set by Percentage width.
- (enh #190): Update German Translations.
- Implement stale bot.
📋 Changes
- (enh #189): Add Bengali Translations.
- (enh #188): Allow `showCaption` when `displayOnly` is `true`.
📋 Changes
- Enhancements to support Bootstrap v4.x.
- Better styling of stars for the 5 rating sizes and maintain consistency across themes.
- (enh #187): Add Kazakh translations.
- (enh #184): Correct rating-input style to keep it hidden - yet trigger required validation.
- (enh #182): New Krajee Font Awesome 5.x `fas` theme.
- (bug #177, enh #179): New property `showCaptionAsTitle`
- Useful for caption to be displayed as title for readonly ratings.
📋 Changes
- (bug #173): Correct `rating:change` event.
- (enh #171): Rename events to start with `rating:` instead of `rating`.
- (enh #170): Enhancements to support Bootstrap v4.x framework.
📋 Changes
- Chronological sorting of issues and enhancements in the CHANGE log.
- (enh #164): Add Turkish Translations.
- (enh #163): Add Korean Translations.
- (enh #162): Add Italian Translations.
- (enh #161): Add Farsi Translations.
- (enh #156): More correct form reset event listening.
- (enh #155): Styling enhancements and code optimizations.
- (enh #154): New property `zeroAsNull` to treat zero value rating as null.
- + 13 more
📋 Changes
- enhance public methods like `create`, `destroy`, `refresh`, `clear`, `reset` to return the rating element jQuery object
📋 Changes
- New property `theme` will assign a CSS class `rating-<theme-name>` to the rating container.
- Themes included
- The default (blank) theme (for displaying bootstrap glyphicons)
- `krajee-svg` (for displaying svg icons)
- `krajee-uni` (for displaying unicode symbols as stars)
- `krajee-fa` (for displaying font awesome icons)
- Add ability to override and add one's own themes
- REMOVED: `symbol`, `glyphicon`, `ratingClass` properties will be removed.
- + 7 more
**Date:** 16-Feb-2016 1. (enh #88): Add German Translations. 2. (enh #89): Add Portugese Brazilian Translations. 3. (bug #90): Rename reserved word used as variable.
**Date:** 22-Jan-2016 1. (enh #84): Add Ukranian Translations. 2. (enh #86): Refactor code for listening events and deep extend options correctly.
**Date:** 29-Dec-2015 1. (enh #76): Add Russian Translations. 2. (bug #77): Correct `touches` and `changedTouches` validation. 3. (enh #81): Simplify README docs. 4. (enh #82): Added "main" key into NPM package.json.
**Date:** 22-Nov-2015 1. (enh #71): Fix `Error: Cannot read property 'pageX' of undefined` error on touch devices. 2. (enh #74): Universal Module Definition for use with CommonJS, AMD or browser globals. 3. (enh #75): Implement Locales and Translations.
**Date:** 20-Sep-2015 1. (enh #47): Styling enhancements for printed output (better star colors and hide clear button). 2. (enh #59): Remove `String.prototype.replaceAll` and implement regex replace. 3. (enh #63): Add `package.json` for npm install. 4. Update bootstrap bower version to support only 3.x variants.
**Date:** 18-Jun-2015 1. (enh #58): Remove redundant tooltip title on hover of caption element. 2. Fixes for composer.json dependencies.
**Date:** 10-May-2015 1. (enh #45): Validate on `touchstart` for devices that do not support `click` event. 2. (enh #46): More correct init of `clear` and `caption` elements.
📋 Changes
- New property `ratingClass` added to allow configuring other icon framework css classes.
**Date:** 31-Jan-2015 1. (enh #39): Prevent invalid star rating for numStars > 5 with default value & hoverChange enabled. 2. (enh #42): Code cleanup and restructure for JS lint changes (using JSHint Code cleanup library).
**Date:** 16-Dec-2014 1. (enh #35): Added `destroy` method to destroy the rating plugin. 2. (enh #36): Added `create` method to create the rating plugin (typically after a destroy).
**Date:** 17-Nov-2014 1. (bug #32): Prevent invalid star ratings if cursor is close to left/right edge of star array. 2. (enh #33): Enhance touch methods for compatibility across more wider mobile device browsers.
**Date:** 08-Nov-2014 1. Set release to stable in composer.json. 2. Updated CHANGE log to reflect user friendly date time formats.
**Date:** 2014-10-27 1. enh #26: Add touch device support to enable touch and slide across stars. 2. enh #27: Reset events on the rating element before every refresh. 3. enh #28: Add rating.refresh event.
📋 Changes
- `hoverEnabled`: _boolean_ whether hover functionality is enabled. This will dynamically change the stars and caption on mouse hover. Defaults to `true`. This functionality will only work on desktop devices and if the input is not `disabled` or `readonly`.
- `hoverChangeCaption`: _boolean_ control whether the caption should dynamically change on mouse hover. Defaults to `true`. Will be applicable only if `hoverEnabled` is `true`.
- `hoverChangeStars`: _boolean_ control whether the stars should dynamically change on mouse hover. Defaults to `true`. Will be applicable only if `hoverEnabled` is `true`.
- `rating.hover`
- `rating.hoverleave`
**Date: 2014-08-23** 1. enh #17: Dynamic configuration for `starCaptions` and `starCaptionClasses` using a function.
# version 2.5.0 Date 2014-05-27 1. Change to entire plugin code to eliminate dependency of HTML5 input. Plugin size reduced to 8KB minified. 2. Uses special JQuery routines to trigger star rating changes. 3. Plugin support is now extended to all browsers including pre IE10 4. Plugin support is now extended to all Touch based and mobile devices like iOS, Android. 5. Removed cloning of inputs to allow better refreshing of input across ajax and other scenarios. 6. Caption and Clear elements parameters treated as identifiers rather than JQuery object elements.
# version 2.0.0 & 2.1.0 Date 2014-05-08 1. Bug #8,#9,#10: Correct cloning and conversion of field to a range slider input. **NEW RELEASE** Date: 2014-04-25 1. Revamp of entire plugin code. Cleverly leverages CSS3 styles, animations, and HTML5 input features to render the plugin. 2. Render and display fractional star ratings. Configure number of stars, min, max, step, and theoretically support any fractional rating. 3. Right to left (RTL) support enhancement. Optimally uses the `dir` attribute of the range input. 4. Bootstrap style is made optional and configurable. Can override CSS to use any style. 5. Any star symbol (unicode or icon font) can be embedded instead of Glyphicon. 6. Uses HTML 5 range input to change ratings. Polyfills for range input in case JQuery/Javascript is disabled. 7. Automatically degrades to a normal SELECT dropdown input for browsers that do not support HTML 5 range input.
