pickadate.js v3.0.0 Release Notes

  • πŸš€ With this major release, the entire API has been rethought to allow the picker to be much more configurable and extensible. These are the most notable updates:

    • #20: Introduced a new time picker.
    • #112: Firefox select month/year fix.
    • #84: Scrollbar not hidden to avoid page shift.
    • πŸ‘ #89: Better event handling on clicks/focuses/keydowns within the holder.
    • #98: Destroy picker data from element.
    • βž• Added Grunt.js build system.
    • βž• Added QUnit test suite.
    • βž• Added Travis integration.
    • ⚑️ Updated themes to be LESS-based.
    • βœ‚ Removed β€œinline” and β€œinline-fixed” themes.
    • βœ‚ Removed jam.js bindings within package.json.
    • βœ‚ Removed official support for IE7. Still works but looks odd.

    To enable all this goodness, some backward-incompatible changes have been introduced. These are the main ones:

    • #85: Months have zero-as-index:

      Just as in JavaScript’s native Date object, the month used to create dates is now based on zero as the first index. Meaning:

      [2013,0,1] β†’ January 01, 2013
      [2013,11,1] β†’ December 01, 2013
      
    • API revised:

      isOpen β†’ get('open')
      getDate β†’ get('select')
      getDateLimit β†’ get('min') or get('max')
      setDate β†’ set('select', …)
      setDateLimit β†’ set('min', …) or set('max', …)
      show β†’ set('view', …)
      
    • Options revised:

      showMonthsFull β†’ showMonthsShort
      showWeekdaysShort β†’ showWeekdaysFull
      yearSelector β†’ selectYears
      monthSelector β†’ selectMonths
      dateMin β†’ min
      dateMax β†’ max
      datesDisabled β†’ disable
      onSelect β†’ onSet
      
    • 🚚 Options removed:

      monthPrev
      monthNext
      

      To add labels for the month navigation tabs, use CSS pseudo-elements instead.

    • A few HTML classes name and property changes.

    • Formatting rules that appear within a word need to be escaped with an exclamation mark (!).

    πŸ‘€ Please do read the docs and api to see exactly how these new options and methods work.