@plmeks94/air-datepicker

🎉 New version released! 🎉

Air Datepicker

Lightweight, dependency-free, fast, customizable datepicker written in pure JavaScript. Works in all modern browsers which supports native css variables.

Install

npm i air-datepicker

Usage

import AirDatepicker from 'air-datepicker'
import 'air-datepicker/air-datepicker.css'

new AirDatepicker('#el' [, options]);

Demo and docs

• Version 3
• Version 2

Recent updates

v3.4.0

• added new options onFocus and onBeforeSelect grant you more control over range selection behaviour and more #526
• added new method getViewDates() allows you to get all dates that should be currently displayed in calendar #536
• toggleSelected now can be a function #534
• fixed clear method #546
• added Bulgarian locale, thanks to tonytomov, in #531
• added Catalan locale, thanks to joatb, in #542
• added Croatian Locale, thanks to diomed, in #551

v3.3.5

• added handling of optional chaining operator in dist package #518
• added Indonesian locale, thanks to BariqDharmawan, in #517

v3.3.4

• recreate global container if it was removed from DOM #516
• added Greek locale, thanks to sonole, in #515

v3.3.3

• fixed time format in timepicker body #512

v3.3.2

• fixed day period value, when selecting date while datepicker is not active, #510
• fixed German locale, #511

v3.3.1

• added Japanese locale, thanks to kyong0612, in #505
• added Korean locale, thanks to YankeeTube, in #506

v3.3.0

• new feature that allow you to add custom attributes via onRenderCell #502, read docs
• fixed selecting cell when using custom html with onRenderCell option #502

v3.2.1

• added Arabic locale, thanks to abdo-host #497
• added Italian locale, thanks to msaltieri #498

v3.2.0

• added onClickDayName option, #459
• added silent param to clear method, #477
• added Swedish locale, thanks to naton #207
• fixed error when trying to call update method with view parameter on hidden calendar, #476
• fixed styles issue with time sliders, #489
• fixed English docs description, #490
• fixed typings for formatDate method, #491

Version 3.0.0 highlights

It is been a while since the last release, a lot of work has been done, and I'm glad to finally present a new version of Air Datepicker.

The main goal was to remove jQuery dependency, and I'm happy to announce that Air Datepicker is no longer need any dependency, hurray! 🥳

Now it's written in ES6, uses native css variables for easy customization, and it's all built with webpack.

Soooo, here is the full list of changes:

• no more jQuery
• improve rendering process - remove redundant cell render when selecting date, which gave a large speed boost compared to the old version
• date format tokens now use Unicode Technical Standard
• TypeScript support
• added selectedDates option, to be able to select dates from the start
• added a possibility to create custom buttons
• now one could change selected range by dragging dates
• added container option which allows you to place datepicker in a custom element
• navTitles can receive a function and could render dynamically
• dateFormat now can receive a function
• onSelect and onRenderCell callbacks are now receive a single object as an argument instead of multiple parameters
• selectDate now receives second parameter with options
• onChangeMonth, onChangeYear, onChangeDecades are replaced with single option onChangeViewDate
• localization now must be provided as an object instead of string as it was before

Contribution

• To run project run npm i, then npm run dev:serve.
• If you want to report a bug, please provide steps and code to reproduce it or create a live example. You could use this template for creating sandbox
• If you have a question please ask it on StackOverflow with tag air-datepicker
• If you have a proposal or PR please submit it to the main branch - please follow code style according to .eslint configuration. Also make sure that your effort is aligned with project roadmap - my goal is to keep datepicker clean and lightweight (under 15kb) without overcomplications or narrowly focused features

Thank you! 😊

License

Air Datepicker is MIT licensed.