Color Calendar

A customizable events calendar component library. Checkout Demo 1, Demo 2 and Demo 3.

Features
Getting Started
- CDN
- NPM
Usage
- Basic
- React
- Vue
Options
Events
Methods
Types
Themes
Bug Reporting
Feature Request
Release Notes
License

🚀 Features

Zero dependencies
Add events to calendar
Perform some action on calendar date change
Month and year picker built-in
Themes available
Fully customizable using CSS variables, passing options parameters while creating calendar, or overriding CSS.
Request more features...

📦 Getting Started

CDN

JavaScript

<script src="https://cdn.jsdelivr.net/npm/color-calendar/dist/bundle.js">

Also available on unpkg.

CSS

Pick a css file according to the theme you want.

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/color-calendar/dist/css/theme-basic.css"
/>
<!-- or -->
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/color-calendar/dist/css/theme-glass.css"
/>

Fonts

Get fonts from Google Fonts

<link
  href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;600;700&display=swap"
  rel="stylesheet"
/>

Check what fonts the theme needs or pass your own fonts in options.

NPM

You might need to use a module bundler such as webpack, rollup, parcel, etc.

Installation

npm i color-calendar

Import

import Calendar from "color-calendar";

CSS

import "color-calendar/dist/css/theme-<THEME-NAME>.css";

Then add fonts.

🔨 Usage

Basic

JavaScript

new Calendar();

Or you can pass in options.

new Calendar({
  id: "#color-calendar",
  calendarSize: "small",
});

HTML

<div id="color-calendar"></div>

Example

React

Example

Vue

Example

⚙️ Options

`id`

Type: String
Default: #color-calendar

Selector referencing HTMLElement where the calendar instance will bind to.

`calendarSize`

Type: String
Default: large
Options: small | large

Size of calendar UI.

`layoutModifiers`

Type: LayoutModifier[]
Default: []
Example: ['month-left-align']

Modifiers to alter the layout of the calendar.

`eventsData`

Type: EventData[]
Default: null

[
    {
        start: '2020-08-17T06:00:00',
        end: '2020-08-18T20:30:00',
        className: 'important_date',
        name: 'Blockchain 101'
      ...
    },
    ...
]

Array of objects containing events information.

Note: Properties start and end are required for each event in the ISO 8601 date and time format. You can optionally choose to add other properties.

`theme`

Type: String
Default: basic
Options: basic | glass

Choose from available themes.

`primaryColor`

Type: String
Default: based on theme
Example: #1a237e

Main color accent of calendar. Pick a color in rgb, hex or hsl format.

`headerColor`

Type: String
Default: based on theme
Example: rgb(0, 102, 0)

Color of header text.

`headerBackgroundColor`

Type: String
Default: based on theme
Example: black

Background color of header. Only works on some themes.

`weekdaysColor`

Type: String
Default: based on theme

Color of weekdays text. Only works on some themes.

`weekdayDisplayType`

Type: String
Default: short
Options: WeekdayDisplayType (short | long-lower | long-upper)

Select how weekdays will be displayed. E.g. M, Mon, or MON.

`monthDisplayType`

Type: String
Default: long
Options: MonthDisplayType (short | long)

Select how month will be displayed in header. E.g. Feb, February.

`startWeekday`

Type: Number
Default: 0
Options: 0 | 1 | 2 | 3 | 4 | 5 | 6

Starting weekday. Mapping: 0 (Sun), 1 (Mon), 2 (Tues), 3 (Wed), 4 (Thurs), 5 (Fri), 6 (Sat)

`fontFamilyHeader`

Type: String
Default: based on theme
Example value: 'Open Sans', sans-serif

Font of calendar header text.

`fontFamilyWeekdays`

Type: String
Default: based on theme

Font of calendar weekdays text.

`fontFamilyBody`

Type: String
Default: based on theme

Font of calendar days as well as month and year picker text.

`dropShadow`

Type: String
Default: based on theme

Set CSS of calendar drop shadow.

`border`

Type: String
Default: based on theme
Example value: 5px solid black

Set CSS style of border.

`borderRadius`

Type: String
Default: 0.5rem

Set CSS border radius of calendar.

`disableMonthYearPickers`

Type: Boolean
Default: false

If month and year picker should be disabled.

`disableDayClick`

Type: Boolean
Default: false

If day click should be disabled.

`disableMonthArrowClick`

Type: Boolean
Default: false

If month arrows should be disabled.

`customMonthValues`

Type: String[]
Default: undefined

Set custom display values for Month.

`customWeekdayValues`

Type: String[]
Default: undefined

Set custom display values for Weekdays.

["Lun", "Mar", "Mer", "Jeu", "Ven", "Sam", "Dim"];

🖱 Events

`dateChanged`

Type: Function
Props:

currentDate
- Type: Date
- Currently selected date
filteredDateEvents
- Type: EventData[]
- All events on that particular date

const options = {
    ...
    dateChanged: (currentDate?: Date, filteredDateEvents?: EventData[]) => {
        // do something
    };
    ...
}

Emitted when the selected date is changed.

`selectedDateClicked`

Type: Function
Props:

currentDate
- Type: Date
- Currently selected date
filteredMonthEvents
- Type: EventData[]
- All events on that particular month

Emitted when the selected date is clicked.

`monthChanged`

Type: Function
Props:

currentDate
- Type: Date
- Currently selected date
filteredMonthEvents
- Type: EventData[]
- All events on that particular month

Emitted when the current month is changed.

🔧 Methods

`reset()`

Reset calendar to today's date.

// Example
let myCal = new Calendar();
myCal.reset();

`setDate()`

Props:

Props	Type	Required	Description
date	Date	required	New date to be set

Set new selected date.

// Example
myCal.setDate(new Date());

`getSelectedDate()`

Return:

Type: Date
Description: Currently selected date

Get currently selected date.

`getEventsData()`

Return:

Type: EventData[]
Description: All events

Get events array.

`setEventsData()`

Props:

Props	Type	Required	Description
events	EventData[]	required	Events to be set

Return:

Type: Number
Description: Number of events set

Set a new events array.

`addEventsData()`

Props:

Props	Type	Required	Description
events	EventData[]	required	Events to be added

Return:

Type: Number
Description: Number of events added

Add events of the events array.

`setWeekdayDisplayType()`

Props:

Props	Type	Required	Description
weekdayDisplayType	WeekdayDisplayType	required	New weekday type

Set weekdays display type.

// Example
myCal.setWeekdayDisplayType("short");

`setMonthDisplayType()`

Props:

Props	Type	Required	Description
monthDisplayType	MonthDisplayType	required	New month display type

Set month display type.

💎 Types

`EventData`

{
    start: string,    // ISO 8601 date and time format
    end: string,      // ISO 8601 date and time format
    className?: string,   // string
    [key: string]: any,
}

`WeekdayDisplayType`

"short" | "long-lower" | "long-upper"

// "short"
M T W ...

// "long-lower"
Mon Tue Wed ...

// "long-upper"
MON TUE WED ...

`MonthDisplayType`

"short" | "long"

// "short"
Jan Feb Mar ...

// "long"
January February March ...

`LayoutModifier`

"month-align-left"

🎨 Themes

Currently 2 themes available. More on the way.

`basic`

CSS Custom Properties

--cal-color-primary: #000000;
--cal-font-family-header: "Work Sans", sans-serif;
--cal-font-family-weekdays: "Work Sans", sans-serif;
--cal-font-family-body: "Work Sans", sans-serif;
--cal-drop-shadow: 0 7px 30px -10px rgba(150, 170, 180, 0.5);
--cal-border: none;
--cal-border-radius: 0.5rem;
--cal-header-color: black;
--cal-weekdays-color: black;

`glass`

CSS Custom Properties

--cal-color-primary: #EC407A;
--cal-font-family-header: 'Open Sans', sans-serif;
--cal-font-family-weekdays: 'Open Sans', sans-serif;
--cal-font-family-body: 'Open Sans', sans-serif;
--cal-drop-shadow: 0 7px 30px -10px rgba(150, 170, 180, 0.5);
--cal-border: none;
--cal-border-radius: 0.5rem;
--cal-header-color: white;
--cal-header-background-color: rgba(0, 0, 0, 0.3);

🐛 Bug Reporting

Feel free to open an issue on GitHub if you find any bug.

⭐ Feature Request

Feel free to Open an issue on GitHub to request any additional features you might need for your use case.
Connect with me on LinkedIn. I'd love ❤️️ to hear where you are using this library.

📋 Release Notes

Check here for release notes.

📜 License

This software is open source, licensed under the MIT License.

cherrol/color-calendar

Color Calendar

🚀 Features

📦 Getting Started

CDN

JavaScript

CSS

Fonts

NPM

Installation

Import

CSS

🔨 Usage

Basic

JavaScript

HTML

React

Vue

⚙️ Options

id

calendarSize

layoutModifiers

eventsData

theme

primaryColor

headerColor

headerBackgroundColor

weekdaysColor

weekdayDisplayType

monthDisplayType

startWeekday

fontFamilyHeader

fontFamilyWeekdays

fontFamilyBody

dropShadow

border

borderRadius

disableMonthYearPickers

disableDayClick

disableMonthArrowClick

customMonthValues

customWeekdayValues

🖱 Events

dateChanged

selectedDateClicked

monthChanged

🔧 Methods

reset()

setDate()

getSelectedDate()

getEventsData()

setEventsData()

addEventsData()

setWeekdayDisplayType()

setMonthDisplayType()

💎 Types

EventData

WeekdayDisplayType

MonthDisplayType

LayoutModifier

🎨 Themes

basic

CSS Custom Properties

glass

CSS Custom Properties

🐛 Bug Reporting

⭐ Feature Request

📋 Release Notes

📜 License

`id`

`calendarSize`

`layoutModifiers`

`eventsData`

`theme`

`primaryColor`

`headerColor`

`headerBackgroundColor`

`weekdaysColor`

`weekdayDisplayType`

`monthDisplayType`

`startWeekday`

`fontFamilyHeader`

`fontFamilyWeekdays`

`fontFamilyBody`

`dropShadow`

`border`

`borderRadius`

`disableMonthYearPickers`

`disableDayClick`

`disableMonthArrowClick`

`customMonthValues`

`customWeekdayValues`

`dateChanged`

`selectedDateClicked`

`monthChanged`

`reset()`

`setDate()`

`getSelectedDate()`

`getEventsData()`

`setEventsData()`

`addEventsData()`

`setWeekdayDisplayType()`

`setMonthDisplayType()`

`EventData`

`WeekdayDisplayType`

`MonthDisplayType`

`LayoutModifier`

`basic`

`glass`