@cevad-tokatli/date-picker

Date Picker

Date Picker is a JavaScript library for setting and choosing date and hour.

NPM

npm install --save @cevad-tokatli/date-picker

Yarn

yarn add @cevad-tokatli/date-picker

Installation

import DatePicker from '@cevad-tokatli/date-picker';

const picker = new DatePicker({
    el: '#picker',
    toggleEl: '#toggle',
    inputEl: '#input'
});

Add the css file.

<link rel="stylesheet" href="/node_modules/@cevad-tokatli/date-picker/css/date-picker.min.css" />

Settings

Option	Type	Default	Description
value	String|Number|Date	null	The picker's initial value.
el	String|HTMLElement*	null	Main element which, picker is created below.
inputEl	String|HTMLElement*	null	Input element.
toggleEl	String|HTMLElement*	null	Toggle element.
type	String	"DATE"	Sets picker type. (DATE, HOUR, DATEHOUR)
dateType	String	"DD/MM/YYYY"	Sets date type. (DD/MM/YYYY, MM/DD/YYYY)
hourType	String	"12"	Sets hour type. (12, 24)
allowEmpty	Boolean	true	A boolean value that indicates whether null and empty value are allowed or not.
showButtons	Boolean	false	A boolean value that indicates whether the buttons are visible or not.
inputToggle	Boolean	true	If sets true, opens the picker when the input is clicked.
lang	String	"en"	Changes language of the picker. You have to create a language except “en (English)” before use it.
orientation	Boolean	false	If it is set true, up arrow increases value, down arrow decreases. If it is set false, vice versa.
showArrowButtons	Boolean	false	Displays increase and decrase buttons instead of arrows.

*: You can give an HTML element or a CSS selector (like #carousel, .container > div:first-child)

Methods

Method	Params	Return	Description
get		{ value: String, day: Number, month: Number, year: Number, hour: Number, minute: Number, am: Boolean }	Returns the value.
set	value: String|Number|Date	void	Sets the value.
open		void	Opens the picker.
close		void	Closes the picker.
toggle		void	Toggles the picker.
save		void	Saves the selection.
cancel		void	Cancels the selection.
destroy		void	Destroys the picker.

Events

Event	Description
wdp.change	Fires when the value changes.
wdp.open	Fires when the picker opens.
wdp.close	Fires when the picker closes.
wdp.save	Fires when the selection is saved.
wdp.cancel	Fires when the picker is closed without being saved.
wdp.destroy	Fires when the picker is destroyed.

import DatePicker from '@cevad-tokatli/date-picker';

const picker = new DatePicker({
  el: '#picker'
});

picker.el.addEventListener('wdp.open', () => {
  console.log('open');
});

picker.el.addEventListener('wdp.close', () => {
  console.log('close');
});

Set Position

When window is scrolled or resized and triggers scroll or resize event, Date Picker repositions the picker. If you use third party scroll or resize library that don't trigger window resize or scroll event, you can manually call method setPosition to reposition the picker.

var picker = new DatePicker({
  el: '#picker'
});

...
...
...
...
picker.setPosition();

Language

You can create a language to use with lang attribute.

import DatePicker from '@cevad-tokatli/date-picker';

DatePicker.createLanguage('tr', {
    DAYS_ABBR: ['', 'Pzt', 'Sal', 'Çar', 'Per', 'Cum', 'Cmt', 'Paz'],
    MONTHS: ['', 'Ocak', 'Şubat', 'Mart', 'Nisan', 'Mayıs', 'Haziran', 'Temmuz', 'Ağustos', 'Eylül', 'Ekim', 'Kasım', 'Aralık'],
    MONTHS_ABBR: ['', 'Oca', 'Şub', 'Mar', 'Nis', 'May', 'Haz', 'Tem', 'Ağu', 'Eyl', 'Eki', 'Kas', 'Ara'],
    AM_PM: ['ÖÖ', 'ÖS'],
    BUTTONS: ['İPTAL', 'TAMAM'],
    INVALID_DATE: 'Geçersiz Tarih'
});

new DatePicker({
  el: '#picker',
  lang: 'tr'
});

Theme

You can change colors of the picker by adding a css class to main element.

<div id="picker"></div>
<div id="blue-picker" class="wdp-blue"></div>
<div id="cyan-picker" class="wdp-cyan"></div>
<div id="dark-picker" class="wdp-dark"></div>
<div id="gray-picker" class="wdp-gray"></div>
<div id="green-picker" class="wdp-green"></div>
<div id="light-picker" class="wdp-light"></div>
<div id="purple-picker" class="wdp-purple"></div>
<div id="red-picker" class="wdp-red"></div>
<div id="yellow-picker" class="wdp-yellow"></div>

You can also create your own theme for your picker.

Create a new file under theme folder.

// theme/_my_theme.scss

$color: #EEA55B;
$color-dark: #000;
$header-background: $color;
$header-text-color: $color-dark;
$header-icon-color: darken($color, 10%);
$list-el-text-active: $color-dark;
$list-el-background-active: $color;
$hour-input-text: $color-dark;
$button-text: $color-dark;

.wdp.wdp-my-theme {
    @include insert-theme();
}

Import your theme to _theme.scss file`.

// _theme.scss
...
@import 'theme/purple';
@import 'theme/red';
@import 'theme/yellow';
@import 'theme/my_theme';

Bundle css code.

$ gulp css
$ gulp minify-css

You are ready to use your theme.

<div id="picker" class="wdp-my-theme"></div>

License

Date Picker is provided under the MIT License.