Flatpickr
Lightweight and powerful datetime picker.
Official documentation
For more detailed information and examples, see the official documentation: Flatpickr documentation .
How to use?
To add hs.range-datepicker.js
in your page, wrap any block in a parent element with an ID or class and add the same ID or the class in the JS INIT function of the plugin.
Copy-paste the stylesheet <link>
into your <head>
to load the CSS.
<link rel="stylesheet" href="../../assets/vendor/flatpickr/dist/flatpickr.min.css">
Copy-paste the following <script>
near the end of your pages under JS Implementing Plugins to enable it.
<script src="../../assets/vendor/flatpickr/dist/flatpickr.min.js"></script>
Copy-paste the following <script>
near the end of your pages under JS Front to enable it.
<script src="../../assets/js/components/hs.range-datepicker.js"></script>
Copy-paste the init function under JS Plugins Init., before the closing </body>
tag, to enable it.
<script>
$(document).on('ready', function () {
// initialization of range datepicker
$.HSCore.components.HSRangeDatepicker.init('.js-range-datepicker');
});
</script>
Basic example
Basic example that highlights today's day.
<!-- Datepicker -->
<div id="datepickerWrapperFrom" class="u-datepicker input-group">
<div class="input-group-prepend">
<span class="input-group-text">
<span class="fas fa-calendar"></span>
</span>
</div>
<input class="js-range-datepicker form-control bg-transparent rounded-right" type="text" placeholder="From" aria-label="From"
data-rp-wrapper="#datepickerWrapperFrom"
data-rp-date-format="d/m/Y">
</div>
<!-- End Datepicker -->
Range example that shows starting and ending highlighted dates.
<!-- Datepicker -->
<div id="datepickerWrapper" class="u-datepicker w-auto input-group">
<div class="input-group-prepend">
<span class="input-group-text">
<span class="fas fa-calendar"></span>
</span>
</div>
<input class="js-range-datepicker form-control bg-transparent rounded-right" type="date"
data-rp-wrapper="#datepickerWrapper"
data-rp-type="range"
data-rp-date-format="d/m/y"
data-rp-default-date='["05/07/18", "31/07/18"]'>
</div>
<!-- End Datepicker -->
Config
locale: {
firstDayOfWeek: 1 - integer
weekdays: {
shorthand: ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"] - array
}
rangeSeparator: '-' - string
}
nextArrow: '>' - string
prevArrow: '<' - string
onDayCreate: function(){} - callback function
Methods
Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-
, as in data-rp-wrapper=""
.
Attribute | Description |
---|---|
|
If the value is not empty, then indicates the container where the drop-down block with the calendar will be placed. If the value is empty, then the drop-down box will be placed immediately after the closing body tag. |
|
If set to true , then the calendar will behave like a static block in the content. |
|
Type of calendar. Valid values are:
single
|
|
Date format. |
|
The default date (placeholder). |
|
Selected dates. Such dates will be highlighted in styles. |
|
Determines from which day the week begins. |
|
Short names for the days of the week. |
|
Separator which, if data-rp-type="range" is set to indicate 2 dates in the placeholder. |
|
Markup button that shows the next month. |
|
Markup button that shows the previous month. |
|
Performs functions inside when initializing the calendar. By default, a function is assigned that adds the dates specified in the data-rp-event-dates to the dates. |