thedatepicker
TypeScript icon, indicating that this package has built-in type declarations

2.4.0 • Public • Published

TheDatepicker

Highly customizable pure JavaScript Datepicker by Slevomat.cz.

Try DEMO
Playground

  • Pure (Vanilla) javascript, no dependencies
  • Responsive (fullscreen on mobile devices)
  • Appropriate semantics - rendered into <table>
  • Accessible - Can be fully handled by keyboard only; only and only clickable elemets are always <a>; includes ARIA labels
  • Listeners for any event (open / close / (de)select / monthChange / focus)
  • Customizable design - all logical elements has it's predefined CSS classes; simply stylize weekend days, current day, past days, etc... (just examine datepicker HTML by DevTools to see predefined classes)
  • Possible to place it to a custom <div> or just let it float under an <input>
  • Darkmode

Installation:

Download:

https://github.com/thedatepicker/thedatepicker/releases/latest
Link dist/the-datepicker.min.js and dist/the-datepicker.css in your HTML.

NPM:

npm i thedatepicker

CDN:

https://cdn.jsdelivr.net/npm/thedatepicker@latest/dist/the-datepicker.min.js
https://cdn.jsdelivr.net/npm/thedatepicker@latest/dist/the-datepicker.css

Usage:

<html>
    <head>
        <script src="dist/the-datepicker.min.js"></script>
        <link rel="stylesheet" href="dist/the-datepicker.css">
    </head>
    
    <body>
        <input type="text" id="my-input">
    </body>
    
    <script>
        const input = document.getElementById('my-input');
        const datepicker = new TheDatepicker.Datepicker(input);
        datepicker.render();
    </script>
</html>

Customize:

TheDatepicker.Datepicker constructor accepts two arguments. First is an instance of an input element, second is an instance of a container element. Both are optional, but at least one must be present.

For example ...

<div id="my-container"></div>

<script>
const container = document.getElementById('my-container');
const datepicker = new TheDatepicker.Datepicker(null, container);
datepicker.render();
</script>

... will render the datepicker into the given <div>.

Options:

To see bunch of possible settings, visit https://thedatepicker.github.io/thedatepicker/

For example:

datepicker.options.setMinDate('today');

datepicker.options.setInputFormat('d M Y'); // "03 Mar 2022"

datepicker.options.setHideOnBlur(false);

datepicker.options.setAllowEmpty(false);

datepicker.options.onSelect(function (event, day) {
    alert('Selected ' + (day ? day.getFormatted() : 'NONE'));
});

datepicker.options.addDateAvailabilityResolver(function (date) {
    return date.getDay() !== TheDatepicker.DayOfWeek.Saturday
        && date.getDay() !== TheDatepicker.DayOfWeek.Sunday
});

datepicker.options.setGoBackHtml('<img src=back.png>');

// and much more...
  • Some options take effect only if changed before the first datepicker open.
  • Learn more about options in source code (setters are commented, search for public set*, public add*, public on*).
  • Do not forget to call datepicker.render() to start using datepicker.
  • Changing options after render takes effect immediately only if you call datepicker.render() again.

Readme

Keywords

Package Sidebar

Install

npm i thedatepicker

Weekly Downloads

30

Version

2.4.0

License

MIT

Unpacked Size

823 kB

Total Files

47

Last publish

Collaborators

  • hejdav