The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
Homepage - Date picker - Time picker - API
Download v3.3.1 or git clone git://github.com/amsul/pickadate.js.git
or bower install pickadate
## Upgrading from v2 to v3
The v3 API is significantly different from v2 (all for the greater good!). So if you’re upgrading to v3, make sure to read the changelog.
## Library files
The lib
folder includes all the compiled files and a compressed
folder with the minified counter-parts. These files are all generated from the _raw/lib
folder using Grunt.
There are currently two pickers: date and time.
File | Contents | Size (min & gzip) |
---|---|---|
picker.js |
Base * | 1.37kb |
picker.date.js |
Date picker | 2.14kb |
picker.time.js |
Time picker | 1.50kb |
* The base script is required for any of the pickers to function.
To support old browsers, namely IE8, also include the legacy.js
file.
All themes are generated using LESS and compiled into the lib/themes
folder.
File | Contents | Size (min & gzip) |
---|---|---|
default.css |
Base default * | 0.51kb |
default.date.css |
Default date picker | 0.67kb |
default.time.css |
Default time picker | 0.35kb |
classic.css |
Base classic * | 0.37kb |
classic.date.css |
Classic date picker | 0.67kb |
classic.time.css |
Classic time picker | 0.35kb |
rtl.css |
RTL language stylings ** | 0.10kb |
* One and only one base stylesheet is required. Choose a theme then include the respective pickers as well.
** For languages with text flowing from right-to-left, also include the rtl.css
stylesheet.
The translations are copied into the lib/translations
folder. There are currently 34 languages included.
## Building with Grunt
Grunt ~0.4.1
is used to build the project files. To get started, clone the project and then run:
npm install
to get the required node modules.grunt --verbose
to confirm you have all the dependencies.
Read the Gruntfile to see the build tasks and relative directories of the source files.
## Styling with LESS
The picker themes are built using LESS with Grunt. To customize the CSS output, read the _variables.less
file in the _raw/lib/themes
folder. You can specify:
- colors for the theme,
- sizes for the picker,
- media-query breakpoints,
- and a whole bunch of other stuff.
After making any changes, run grunt less:themes
to compile it into CSS.
## Versioning
To maintain some consistency in the sort of changes to expect with version bumps, Semantic Versioning guidelines will now be followed as closely as possible:
<major>.<minor>.<patch>
Constructed as such:
major
: breaks backward compatibility (resets theminor
andpatch
)minor
: new additions with backward compatibility (resets thepatch
)patch
: bug fixes and misc changes
## Bugs
Before opening a new issue, please search the existing Issues for anything similar – there might already be an answer to your problem. You might also wanna check out the Contributing guide.
## Contributing
Before contributing any code to the project, please take a look at the Contributing guide.
© 2013 Amsul
Licensed under MIT