Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amsul/pickadate.js
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
https://github.com/amsul/pickadate.js
calendar date picker time
Last synced: about 2 months ago
JSON representation
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
- Host: GitHub
- URL: https://github.com/amsul/pickadate.js
- Owner: amsul
- License: mit
- Created: 2012-11-16T01:36:42.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2023-07-14T10:02:54.000Z (about 1 year ago)
- Last Synced: 2024-05-22T19:39:01.102Z (4 months ago)
- Topics: calendar, date, picker, time
- Language: JavaScript
- Homepage: http://amsul.ca/pickadate.js
- Size: 9.96 MB
- Stars: 7,700
- Watchers: 216
- Forks: 1,017
- Open Issues: 314
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- StarryDivineSky - amsul/pickadate.js
- awesome-javascript - pickadate.js - (Looking for Project Maintainers) The mobile-friendly, responsive, and lightweight jQuery date & time input picker. - ★ 7491 (Form Widgets)
README
# pickadate [](https://travis-ci.org/amsul/pickadate.js) [](https://www.jsdelivr.com/package/npm/pickadate)
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
[](https://spectrum.chat/pickadate)
#### To get started, check out the:
[Homepage](http://amsul.ca/pickadate.js) - [Date picker](http://amsul.ca/pickadate.js/date) - [Time picker](http://amsul.ca/pickadate.js/time) - [API](http://amsul.ca/pickadate.js/api)
#### To get it:
[Download the latest stable build](https://github.com/amsul/pickadate.js/archive/master.zip)
*or*
`git clone git://github.com/amsul/pickadate.js.git`
*or*
`bower install pickadate`
## Library files
The `lib` folder includes the library files with a `compressed` folder containing the minified counter-parts. These files are minified using [Grunt](#building-with-grunt).
### Pickers
There are three picker files:
* `picker.js` The core file (required before any other picker)
* `picker.date.js` The date picker
* `picker.time.js` The time picker
_To support old browsers, namely IE8, **also include** the `legacy.js` file._
### Themes
All themes are [generated using LESS](#less-styling) and compiled from the `lib/themes-source` folder into the `lib/themes` folder.
There are two themes:
* `default.css` The default modal-style theme
* `classic.css` The classic dropdown-style theme
Based on the theme, pick the relevant picker styles:
* `default.date.css` and `default.time.css` when using the default theme
* `classic.date.css` and `classic.time.css` when using the classic theme
__**__ For languages with text flowing from right-to-left, also include the `rtl.css` stylesheet.
### Translations
The translations live in the `lib/translations` folder. There are currently [43 language translations](https://github.com/amsul/pickadate.js/tree/master/lib/translations) included.
## Building with Grunt
[Grunt](http://gruntjs.com/) `~0.4.5` 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 test --verbose` to confirm you have all the dependencies.
Type out `grunt --help` to see a list of all the tasks available. The generally used tasks are:
- `grunt develop` compiles the LESS files and watches for any source changes.
- `grunt package` compiles and then minifies the source files.
- `grunt test` tests the entire package.
The picker themes are built using [LESS](http://lesscss.org/) 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.
## Bugs
Before opening a new issue, please search the existing [Issues](https://github.com/amsul/pickadate.js/issues) for anything similar – there might already be an answer to your problem. You might also wanna check out the [Contributing](https://github.com/amsul/pickadate.js/blob/master/CONTRIBUTING.md) guide.
## Contributing
Before contributing any code to the project, please take a look at the [Contributing](https://github.com/amsul/pickadate.js/blob/master/CONTRIBUTING.md) guide.
If there’s anything you’d like to discuss, we like to hang out on Spectrum.
[](https://spectrum.chat/pickadate)
## Support
If you find this library useful and would like to see further development, consider [supporting it](http://selz.co/1g80kCZ).
---
© 2014 [Amsul](http://twitter.com/amsul_)
Licensed under [MIT](http://amsul.ca/MIT)