The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
To get started, check out the:
To get it:
git clone git://github.com/amsul/pickadate.js.git
bower install pickadate
## Library files
lib folder includes the library files with a
compressed folder containing the minified counter-parts. These files are minified using Grunt.
There are three picker files:
picker.jsThe core file (required before any other picker)
picker.date.jsThe date picker
picker.time.jsThe time picker
To support old browsers, namely IE8, also include the
All themes are generated using LESS and compiled from the
lib/themes-source folder into the
There are two themes:
default.cssThe default modal-style theme
classic.cssThe classic dropdown-style theme
Based on the theme, pick the relevant picker styles:
default.time.csswhen using the default theme
classic.time.csswhen using the classic theme
** For languages with text flowing from right-to-left, also include the
The translations live in the
lib/translations folder. There are currently 43 language translations included.
## Building with Grunt
~0.4.5 is used to build the project files. To get started, clone the project and then run:
npm installto get the required node modules.
grunt test --verboseto confirm you have all the dependencies.
grunt --help to see a list of all the tasks available. The generally used tasks are:
grunt developcompiles the LESS files and watches for any source changes.
grunt packagecompiles and then minifies the source files.
grunt testtests the entire package.
## Styling with LESS
The picker themes are built using LESS with Grunt. To customize the CSS output, read the
_variables.less file in the
lib/themes-source folder. You can specify:
- colors for the theme,
- sizes for the picker,
- media-query breakpoints,
- and a whole bunch of other stuff.
Make sure to run the
grunt develop task before making any changes to compile it into CSS.
To maintain consistency in the sort of changes to expect with version bumps, Semantic Versioning guidelines is followed as closely as possible:
Constructed as such:
major: breaks backward compatibility (resets the
minor: new additions with backward compatibility (resets the
patch: bug fixes and misc changes
If a version bump is due, make sure to update the version with a project-wide search and replace.
Before contributing any code to the project, please take a look at the Contributing guide.
If there’s anything you’d like to discuss, we like to hang out on Gitter.
If you find this library useful and would like to see further development, consider supporting it.
© 2014 Amsul
Licensed under MIT