A datepicker Vue component. Compatible with Vue 2.x

• Demo
• Install
• Upgrade to 2.x+
• Usage
• Date Formatting
• Props
• Events
• Disabled dates
• Highlighted dates
• Translations

this is a fork of https://github.com/charliekassel/vuejs-datepicker, which includes following breaking changes:

• Upgrade all libraries
• uses vue-eslint-parser for eslint.
• Fixed SSR support for NuxtJS (breaking change v2) see also regarding CSS / styles
• Merged #611: show calendar on focus prop
• Merged #626: fixes missing close and open events
• Based on #536: Allow custom types, I changed the method to getTypedDate which should return a fully parsed Date object.
• Added a beforeDateInput slot.
• uses moment.js for translations (breaking change v2+) see momentjs / translations
• dropped internal formatting rules and also used moment.js (breaking change 2.x+) see momentjs / formatting

To view a demo online: https://codesandbox.io/s/vue-datepicker-demo-82x48

To view demo examples locally clone the repo and run npm install && npm run serve

npm install @hokify/vuejs-datepicker

or

yarn add @hokify/vuejs-datepicker

import Datepicker from '@hokify/vuejs-datepicker';

export default {
  // ...
  components: {
    Datepicker
  }
  // ...
}

To upgrade to version 2+ check:

• add explicit css inclues, see regarding CSS / styles
• change translation to moment.js, see momentjs / translations
• change date formats to moment.js, see momentjs / formatting

I've dropped the additional translations and use the moment.js directly, therefore you need to remove all dependenices for the "locale" imports e.g.: import {en, es} from 'vuejs-datepicker/dist/locale'

The language property changed from an locale object to a simple string (en,de,..)! Please see Translations section how to set up your language.

change custom date formatting to moment js date formatting: https://momentjs.com/docs/#/displaying/ Examples:

As this bundle is also useable for SSR rendering, you have to take care of css yourself. (see also vuejs/rollup-plugin-vue#266) I strongly recommend to create a custom component, that wraps the vuejs-datepicker. Then it's easy to add custom css and have a consistent style for the datepicker.

Ensure you have postcss-import up and running. (https://github.com/postcss/postcss-import) E.g.via:

<style lang="scss">
/* purgecss start ignore */
@import "@hokify/vuejs-datepicker/dist/vuejs-datepicker.css"
/* purgecss end ignore */
</style>

If you do not use purgeCSS, you can safely remove the comment lines

add inside nuxt.config:

css: [
 {
  src: '@hokify/vuejs-datepicker/dist/vuejs-datepicker.css',
  lang: 'css'
 },

I'm using this method, as I actually customized the datepicker and therefore don't need to overwrite css classes again with my style.

<style lang="scss">
	.vdp-datepicker {
		overflow: visible;
		display: inline-block;
		....
	}
	...
</style>

Ping me if you have any better approaches! :)

<datepicker></datepicker>

value prop if passed should be a Date object

<script>
var state = {
  date: new Date(2016, 9,  16)
}
</script>
<datepicker :value="state.date"></datepicker>

support name attribute for normal html form submission

<datepicker :value="state.date" name="uniquename"></datepicker>

Using v-model

<datepicker v-model="state.date" name="uniquename"></datepicker>

Emits events

<datepicker @selected="doSomethingInParentComponentFunction" @opened="datepickerOpenedFunction" @closed="datepickerClosedFunction">

Inline always open version

<datepicker :inline="true"></datepicker>

These events are emitted on actions in the datepicker

Uses moment.js for date formatting. See https://momentjs.com/docs/#/displaying/ Examples:

Delegates date formatting to provided function. Function will be called with date and it has to return formated date as a string. This allow us to use date-fns, globalize or any other library to format date.

<script>
  methods: {
    customFormatter(date) {
      return moment(date).format('MMMM Do YYYY, h:mm:ss a');
    }
  }
</script>
<datepicker :format="customFormatter"></datepicker>

Dates can be disabled in a number of ways.

<script>
var state = {
  disabledDates: {
    to: new Date(2016, 0, 5), // Disable all dates up to specific date
    from: new Date(2016, 0, 26), // Disable all dates after specific date
    days: [6, 0], // Disable Saturday's and Sunday's
    daysOfMonth: [29, 30, 31], // Disable 29th, 30th and 31st of each month
    dates: [ // Disable an array of dates
      new Date(2016, 9, 16),
      new Date(2016, 9, 17),
      new Date(2016, 9, 18)
    ],
    ranges: [{ // Disable dates in given ranges (exclusive).
      from: new Date(2016, 11, 25),
      to: new Date(2016, 11, 30)
    }, {
      from: new Date(2017, 1, 12),
      to: new Date(2017, 2, 25)
    }],
    // a custom function that returns true if the date is disabled
    // this can be used for wiring you own logic to disable a date if none
    // of the above conditions serve your purpose
    // this function should accept a date and return true if is disabled
    customPredictor: function(date) {
      // disables the date if it is a multiple of 5
      if(date.getDate() % 5 == 0){
        return true
      }
    }
  }
}
</script>
<datepicker :disabledDates="state.disabledDates"></datepicker>

Dates can be highlighted (e.g. for marking an appointment) in a number of ways. Important: By default disabled dates are ignored, to highlight disabled dates set the includeDisabled property to true. Note: Both to and from properties are required to define a range of dates to highlight.

<script>
var state = {
  highlighted: {
    to: new Date(2016, 0, 5), // Highlight all dates up to specific date
    from: new Date(2016, 0, 26), // Highlight all dates after specific date
    days: [6, 0], // Highlight Saturday's and Sunday's
    daysOfMonth: [15, 20, 31], // Highlight 15th, 20th and 31st of each month
    dates: [ // Highlight an array of dates
      new Date(2016, 9, 16),
      new Date(2016, 9, 17),
      new Date(2016, 9, 18)
    ],
    // a custom function that returns true of the date is highlighted
    // this can be used for wiring you own logic to highlight a date if none
    // of the above conditions serve your purpose
    // this function should accept a date and return true if is highlighted
    customPredictor: function(date) {
      // highlights the date if it is a multiple of 4
      if(date.getDate() % 4 == 0){
        return true
      }
    },
    includeDisabled: true // Highlight disabled dates
  }
}
</script>
<datepicker :highlighted="state.highlighted"></datepicker>

Slots will help you customize content. .

Sometimes you need to show custom content before the calendar header. For such cases you can use the named slot beforeCalendarHeader.

An example would be to use bootstrap's input-group-prepend and input-group-append to show some custom text:

<datepicker :bootstrap-styling="true">
  <div slot="beforeCalendarHeader" class="calender-header">
    Choose a Date
  </div>
</datepicker>

To implement some custom styling on DateINput, you might need to add elemnt beore the DateInput. Similar to afterDateInput, just it is before in the html DOM.

To implement some custom styling (for instance to add an animated placeholder) on DateInput, you might need to add elements as DateInput siblings. Slot named afterDateInput allows you to do that:

<datepicker>
  <span slot="afterDateInput" class="animated-placeholder">
    Choose a Date
  </span>
</datepicker>

See also https://momentjs.com/docs/#/i18n/loading-into-browser/ Especially if you use webpack!

1. You need to load the language file for the locale, e.g. Node:

import 'moment/locale/de';

Browser:

<script src="locale/de.js" charset="UTF-8"></script>

There is also a minified version including all versions:

import 'moment/min/locales.min'

2. specify the language in the datepicker component:

<datepicker language="de"></datepicker>

Available languages are all that moment.js supports. See demo file or https://github.com/moment/moment/tree/develop/locale for a list of available languages and the correct language code for it.