Code Monkey home page Code Monkey logo

air-datepicker's Introduction

๐ŸŽ‰ 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.

air datepicker image

Install

npm i air-datepicker

Usage

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

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

Demo and docs

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

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

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.

air-datepicker's People

Contributors

t1m0n avatar gergo85 avatar dowglaz avatar xiio avatar abdo-host avatar naton avatar bariqdharmawan avatar boatkung avatar yankeetube avatar hreyeslo avatar joatb avatar khidirbekov avatar sonole avatar liborm85 avatar marioaraque avatar matschik avatar ichag avatar diomed avatar msaltieri avatar nicooprat avatar nimeshc64 avatar robinn1 avatar tonytomov avatar kyong0612 avatar think2011 avatar ozkanozcan avatar grawl avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.