kendo-multi-calendar/README.md

Kendo UI calendar with multiple date selection.

kendo-multi-calendar
=========
[![npm version](https://badge.fury.io/js/kendo-multi-calendar.svg?t=1520227475245)](https://badge.fury.io/js/kendo-multi-calendar)
[![Build Status](https://travis-ci.org/iyegoroff/kendo-multi-calendar.svg?t=1520227475245&branch=master)](https://travis-ci.org/iyegoroff/kendo-multi-calendar)
[![codecov](https://codecov.io/gh/iyegoroff/kendo-multi-calendar/branch/master/graph/badge.svg?t=1520227475245)](https://iyegoroff.io/gh/codecov/kendo-multi-calendar)
[![Dependency Status](https://david-dm.org/iyegoroff/kendo-multi-calendar.svg?t=1520227475245)](https://david-dm.org/iyegoroff/kendo-multi-calendar)
[![devDependency Status](https://david-dm.org/iyegoroff/kendo-multi-calendar/dev-status.svg?t=1520227475245)](https://david-dm.org/iyegoroff/kendo-multi-calendar#info=devDependencies)
[![typings included](https://img.shields.io/badge/typings-included-brightgreen.svg?t=1520227475245)](#typescript)
[![npm](https://img.shields.io/npm/l/express.svg?t=1520227475245)](https://www.npmjs.com/package/kendo-multi-calendar)

[![Build Status](https://saucelabs.com/browser-matrix/iyegoroff-6.svg?t=1520227475245)](https://saucelabs.com/beta/builds/c9b5135835524b29b1a1e2e481da380e)

Extended Kendo UI Calendar widget that supports multiselection. [Demo](https://kendo-multi-calendar.surge.sh/)

## Installation

```bash
npm i kendo-multi-calendar
```

kendo-multi-calendar(.min).js script should be included in your project along with kendo-ui-core or kendo-ui.

## Usage

```javascript
var multiCalendar = $("#multiCalendar").kendoMultiCalendar({
    // use 'values' option instead of 'value',
    // defaults to []
    values: [new Date(), new Date(2016, 5, 2)], 

    // set selection limits, 
    // defaults to null - no limit
    maxSelectedItems: 3,

    // if true - only today date will be selected after click on date in footer,
    // if false - today date will be added to selected dates,
    // defaults to true
    cleanSelectedItemsOnTodayClick: false,

    //... everything else is just like in ordinary Kendo UI Calendar
}).data('kendoMultiCalendar');

multiCalendar.values([]);
```

### Typescript

This module also contains type declarations.

```typescript
// use 'reference' directive
/// <reference path="node_modules/kendo-multi-calendar/dist/kendo-multi-calendar.d.ts" />

// or add types to 'compilerOptions' in your tsconfig.json:
// ...
// "types": [ "kendo-multi-calendar" ],
// ...

const calendar = new kendoExt.MultiCalendar('#multiCalendar');
```