A React component that empowers you to create a customizable year calendar with events

React Full Year Scheduler

React full year scheduler is an open source project aimed at providing a simple, customizable, and easy-to-use full year calendar solution for individuals and organizations. The project was created out of a need for a more flexible and accessible calendar tool that can be used for various purposes, such as planning events, tracking deadlines, and scheduling appointments.

Motivation

As a developer, I faced the challenge of finding calendar components that could easily integrate into my personal or company’s projects. Despite my efforts, I couldn’t find a suitable solution, leading me to recognize the need for a more versatile and customizable calendar tool. This inspired me to undertake this project.

The primary goal of this project is to create a comprehensive full-year calendar that can be easily customized and seamlessly integrated into any website or web application. I strongly believe that an outstanding calendar should be user-friendly and highly adaptable, enabling users to personalize it to their unique requirements.

Features

  • 👌 Year-at-a-glance view

  • 🕤 Ability to set holidays and working days for employees (example usage)

  • ✨ Highlight and customize events with different colors and styles

  • 👀 Customizable styling and layout

  • ❕ Show tooltip with event details on hover

  • ⚡ Lightweight and performant with no external dependencies except Datejs and TailwindCSS

  • 👐 Open source and free to use

Installation

To install the React Full Year Scheduler , run the following command:

yarn add react-full-year-scheduler

Usage

To use this component in your React application, import the ReactFullYearScheduler component from the appropriate file, and pass it the required events prop as an array of TEvent objects, along with any desired options. Here is an example of how you can use this component:

import  dayjs  from  "dayjs";
import { useState } from  "react";
import { ReactFullYearScheduler } from "react-full-year-scheduler";
import  "react-full-year-scheduler/dist/style.css";

function  App() {
const [events, setEvents] =  useState<TEvent[]>([

{
	eventName: "event 1",
	startDate: dayjs("2023-01-10"),
	endDate: dayjs("2023-02-01"),
	eventBgColor: "#ff5f4c",
	eventTextColor: "white",
},
{
	eventName: "event 2",
	startDate: dayjs("2023-04-01"),
	endDate: dayjs("2023-04-30"),
	eventBgColor: "purple",
	eventTextColor: "white",
},
{
	eventName: "event 3",
	startDate: dayjs("2023-05-01")
	endDate: dayjs("2023-05-29"),
	eventBgColor: "green",
	eventTextColor: "white",
	},
]);

return (
<div>
<ReactFullYearScheduler
	events={events}
	locale="en"
	dateTooltipTheme="material"
	weekSeparatorWidth={10}
	weekSeparatorColor="white"
	headerWeekDayBgColor="#b39cd0"
	headerWeekendBgColor="rgba(75, 68, 83, 0.69)"
	weekendCellBackgroundColor="rgba(75, 68, 83, 0.69)"
	weekendCellTextColor="white"
	weekDayCellBackgroundColor="rgba(75, 68, 83, 0.69)"
	weekDayCellTextColor="white"
	selectionColor="black"
	selectionTextColor="white"
	maxRangeSelection={20}
	minRangeSelection={10}
	firstDayOfWeek="Monday"
	maxYear={2030}
	minYear={1970}
	readonlyCalendar={false}
	showWeekSeparator={true}
	showTodayButton={true}
	enableYearToYearSelection={false}
	enableWeekendSelection={true}
	minCellWidth={50}
	showSeparatorInHeader={false}
	enableEventOverwriting={true}
	onDatePick={(eventDate, clearSelectedCell) => {
	console.log(eventDate.toDate());
	}}
	onEventSinglePickInterception={(date, eventName, clearSelectedCell) => {
	console.table([eventName, date.toDate()]);
	}}
	onRangePick={(
	eventStartDate,
	eventEndDate,
	clearSecondSelectedCell,
	clearSelection
	) => {
	setTimeout(() => {
	clearSelection();
	}, 3000);
	}}

	onEventRangePickInterception={(
	eventFirstDate,
	eventLastDate,
	eventsToBeDeleted,
	eventsToBeUpdated,
	clearSecondSelectedCell,
	clearSelection
	) => {
	setTimeout(() => {
	clearSelection();
	}, 3000);
	}}
/>
</div>
);
}
export  default  App;

Options

Property Name Type Default Options
events TEvent[]
dateTooltipTheme string "material" "material", "light", "light-border", "translucent"
locale string "en"
weekSeparatorWidth number 10
weekSeparatorColor string “#fefedf”
headerWeekDayBgColor string “#c3b5d5”
headerWeekendBgColor string “#b39cd0”
headerTextColor string “white”
weekendCellBackgroundColor string “#b39cd0”
weekendCellTextColor string “white”
weekDayCellBackgroundColor string “white”
weekDayCellTextColor string “black”
monthNameBackgroundColor string “#f2fedc”
monthNameTextColor string “black”
readonlyCalendar boolean false
enableYearToYearSelection boolean false
enableWeekendSelection boolean true
selectionColor string “#32214c”
selectionTextColor string “white”
maxRangeSelection number
minRangeSelection number
firstDayOfWeek string "Sunday" "Sunday", "Monday"
maxYear number “Monday”
minYear number
showWeekSeparator boolean false
showTodayButton boolean true
minCellWidth number 40
showSeparatorInHeader boolean true
enableEventOverwriting boolean true

Events

Event Arguments Description
onDatePick eventDate: Dayjs, clearSelectedCell: () => void Triggered when a single date is picked.
onEventSinglePickInterception eventDate: Dayjs, InterceptedEventIndex: number, clearSelectedCell: () => void Triggered when a single date is picked while intercepting an existing event.
onRangePick eventStartDate: Dayjs, eventEndDate: Dayjs, clearSecondSelectedCell: () => void, clearSelection: () => void Triggered when picking a range of dates (start date / end date)
onEventRangePickInterception eventStartDate: Dayjs, eventEndDate: Dayjs, eventsToBeDeleted: number[], eventsToBeUpdated: number[], clearSecondSelectedCell: () => void, clearSelection: () => void Triggered when picking a range of dates (start date / end date) while intercepting another event or events.

How to Contribute

We welcome contributions from anyone who is interested in helping to improve this project. Whether you’re an experienced developer or just getting started with open source, there are many ways to contribute:

  • Submit issues and bug reports. If you encounter a problem with the calendar or have a suggestion for improvement, please let us know by submitting an issue on GitHub.

  • Propose new ideas and features. We’re always looking for new ideas and ways to improve the calendar. If you have an idea for a new feature or improvement, please let us know by submitting an issue on GitHub.

  • Contribute code. If you’re a developer and would like to contribute code to the project, please fork the repository, make your changes, and submit a pull request.

  • Spread the word. Help us spread the word about the project by sharing it with your friends and colleagues or writing about it on your blog or social media.

We appreciate all contributions and look forward to working with you to make this project the best it can be!

License

This project is licensed under the MIT License – see the LICENSE for details.

GitHub

View Github