87d0ba3 Jul 4, 2016
@kartik-v @bgaillard
248 lines (164 sloc) 10 KB

Change Log: bootstrap-star-rating

Version 4.0.2

Date: 03-Jul-2016

  1. (enh #108): Add French Translations.
  2. (enh #115): Add Romanian Translations.
  3. (enh #122): Add Spanish Translations.
  4. (enh #123): Add Italian Translations.
  5. (enh #124): Add License Headers.
  6. (enh #127): Add Chinese Translations.
  7. (enh #130): Better management of themes and locales.

Version 4.0.1

Date: 28-Feb-2016

  1. (bug #99): Correct documentation for refresh method.
  2. (bug #100): Correct caption and clear rendering methods.
  3. (bug #101): Correct caption setting when showCaption is false.
  4. (bug #102): Revamp generation of rating via refresh method.
  5. (enh #103): Implement method chaining and revamp private methods
    • enhance public methods like create, destroy, refresh, clear, reset to return the rating element jQuery object
  6. Update package.json to include peerDependencies instead of dependencies.

Version 4.0.0

Date: 16-Feb-2016

  1. (enh #91): Add SVG Icon Support
  2. (enh #94): Add Theming Functionality.

    • New property theme will assign a CSS class with the 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

    Various new features and BC breaking enhancements

    • REMOVED: symbol, glyphicon, ratingClass properties will be removed.
    • The requirement for the above will be replaced with the theme property (and can also be implemented using the containerClass property).
    • Stars now have a better padding and spacing that can be configured via CSS and themes
    • New property filledStar - will allow one to set the markup for filledStar - will default to
      • <i class="glyphicon glyphicon-star"></i>
    • New property emptyStar - will allow one to set the markup for emptyStar - will default to
      • <i class="glyphicon glyphicon-star-empty"></i>
    • Exclusive support for SVG (and a prebuilt krajee-svg theme that contains two different ready to use SVG icons).
  3. (enh #95): Add display only capability.
  4. (enh #96): Add support for bootstrap-sass official repo via sass branch.
  5. (enh #97): Add animate property to enable / disable animation of star highlight on hover / change.

Version 3.5.8

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.

Version 3.5.7

Date: 22-Jan-2016

  1. (enh #84): Add Ukranian Translations.
  2. (enh #86): Refactor code for listening events and deep extend options correctly.

Version 3.5.6

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.

Version 3.5.5

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.

Version 3.5.4

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.

Version 3.5.3

Date: 18-Jun-2015

  1. (enh #58): Remove redundant tooltip title on hover of caption element.
  2. Fixes for composer.json dependencies.

Version 3.5.2

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.

Version 3.5.1

Date: 13-Feb-2015

  1. (enh #44): Ability to integrate with other font icon CSS frameworks like Font Awesome.
    • New property ratingClass added to allow configuring other icon framework css classes.
  2. Set copyright year to current.

Version 3.5.0

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).

Version 3.4.0

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).

Version 3.3.0

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.

Version 3.2.0

Date: 08-Nov-2014

  1. Set release to stable in composer.json.
  2. Updated CHANGE log to reflect user friendly date time formats.

Version 3.1.0

Date: 27-Oct-2014

  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.

Version 3.0.0

Date: 13-Oct-2014

  1. enh #20, #21: Included hover validation routine and rating state change on hover. Following new configurable properties added:

    • 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.
  2. enh #21: Following new events are added:

    • rating.hover
    • rating.hoverleave
  3. enh #22: More correct minimum value and clear value validation through new getWidthFromValue method.

  4. enh #24: Set clearValue to default to min if not set.

Version 2.6.0

Date: 23-Aug-2014

  1. enh #17: Dynamic configuration for starCaptions and starCaptionClasses using a function.

Version 2.5.0

Date: 27-May-2014

  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.1.0

Date: 08-May-2014

  1. Bug #8,#9,#10: Correct cloning and con## Version of field to a range slider input.

Version 2.0.0

Date: 25-Apr-2014

  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.

Version 1.2.0

Date: 04-Apr-2014

  1. Widget is customizable for using any CSS markup to override Bootstrap styles.
  2. Clear button class customization added.

Version 1.1.0

Date: 10-Mar-2014

Revamped the methods for usage across wider scenarios:

  1. Included update method to set a value of a rating via javascript.
  2. Revamped the refresh method to enable refreshing all plugin options at runtime via parameters.

Version 1.0.0

Date: 01-Oct-2013

Initial release. The following features are included in this release:

  1. Convert any HTML input to a star rating control. Recommended input is of type = number, which will help fallback to a number input for browsers not supporting JQuery or Javascript.
  2. The plugin automatically converts an input with type = number to a star rating control if you set its class = rating. All options to the input can be passed as HTML5 data attributes.
  3. Involves pure CSS3 styling of the stars. Say goodbye to image sprites or playing with image backgrounds. Offers clean scalable vector icons for consistent display across devices.
  4. Specifically uses Bootstrap 3.x styles & glyphs. Can be combined to work better for Bootstrap styled projects (or input group addons).
  5. Ability to clear values and options for the stars. Control where the clear button element can be shown.
  6. Reset star rating to the initial value when the form is reset.
  7. Ability to control and display caption of the selected stars. Each rated star can have its own caption. Control where the caption element can be shown.
  8. Ability to size the rating control including the stars, caption, and clear button. Five prebuilt size templates are available xl, lg, md, sm, and xs.
  9. Support for RIGHT TO LEFT (RTL) input. Automatically changes star styling for RTL.
  10. Triggers JQuery events for advanced development. Events currently available are rating.change, rating.clear, and rating.reset.
  11. Disabled and readonly input star rating support.
  12. Size of the entire plugin is less than 9KB (about 6KB for the minified JS and 3KB for the minified CSS).