React Big Schedule is a powerful and intuitive scheduler and resource planning solution built with React. Seamlessly integrate this modern, browser-compatible component into your applications to effectively manage time, appointments, and resources. With drag-and-drop functionality, interactive UI, and granular views, react-big-schedule empowers users to effortlessly schedule and allocate resources with precision.
Enhance productivity and streamline your workflow with this React-based solution, designed to optimize time management and simplify calendar-based operations. Perfect for applications requiring advanced scheduling capabilities, react-big-schedule offers a seamless and intuitive experience for managing appointments, resource allocation, and time slots.
Unlock the potential of your React projects with react-big-schedule and revolutionize the way you handle scheduling and resource planning.
To install react-big-schedule, use npm:
npm install react-big-schedule- React
- Ant Design
- react-dnd
- react-dnd-html5-backend
- webpack
- dayjs
- Modern and intuitive scheduler component for React applications.
- Seamless integration with React projects.
- Drag-and-drop functionality for effortless scheduling.
- Interactive user interface for a smooth user experience
- Granular views to manage time, appointments, and resources effectively.
- Optimized for time management and calendar-based operations.
- Perfect for applications requiring advanced scheduling capabilities.
Contributions to react-big-schedule are welcome! If you find a bug or want to contribute to the project, please follow these steps:
- Fork the repository on GitHub.
- Create a new branch with a descriptive name.
- Make your changes and commit them with clear messages.
- Push your changes to your forked repository.
- Submit a pull request to the master repository.
Please ensure that your code adheres to the project's coding conventions and includes appropriate tests.
React Big Schedule is released under the MIT License. See the LICENSE file for more details.
If you have any questions or need support, please create an issue in the GitHub repository.
React Big Schedule is developed and maintained by the React Big Schedule team. We would like to thank the open-source community for their valuable contributions and feedback.
Special thanks to the following contributors:
- Ansul Agrawal (@ansulagrawal)
- Jitendra Soni (@JitendraSoni1234)
- hbatalhaStch [@hbatalhaStch)
- DamyanBG (@DamyanBG)
We would like to acknowledge the following projects for their inspiration and contributions:
- Additional view options for different scheduling needs.
- Support for recurring appointments.
- Integration with popular calendar services.
- Improved accessibility and localization support.
- Performance optimizations for handling large data sets.
We are continuously working on enhancing react-big-schedule and welcome your feedback and suggestions for future improvements.
Please refer to the CHANGELOG.md file.
1.) Installation
npm i react-big-schedule
or
yarn add react-big-schedule
2.) Import dependencies
import { Scheduler, SchedulerData, ViewType, DATE_FORMAT } from "react-big-schedule";
import dayjs from "dayjs";
import "react-big-schedule/dist/css/style.css";
3.) Basic Usage
const schedulerData = new SchedulerData(new dayjs().format(DATE_FORMAT), ViewType.Week);
//set locale dayjs to the schedulerData, if your locale isn't English. By default, Scheduler comes with English(en, United States).
schedulerData.setSchedulerLocale('pt-br'); // this uses dayjs, but it doesn't require dayjs to be installed as its called dynamically
schedulerData.setCalendarPopoverLocale('pt_BR'); // this uses antd [List of supported locales](https://ant.design/docs/react/i18n#supported-languages)
schedulerData.setResources([
{ id: 'r0', name: 'Resource0', groupOnly: true },
{ id: 'r1', name: 'Resource1' },
{ id: 'r2', name: 'Resource2', parentId: 'r0' },
{ id: 'r3', name: 'Resource3', parentId: 'r4' },
{ id: 'r4', name: 'Resource4', parentId: 'r2' },
]);
// the event array should be sorted in ascending order by event.start property
// otherwise there will be some rendering errors
schedulerData.setEvents([
{
id: 1,
start: '2022-12-18 09:30:00',
end: '2022-12-19 23:30:00',
resourceId: 'r1',
title: 'I am finished',
bgColor: '#D9D9D9',
},
{
id: 2,
start: '2022-12-18 12:30:00',
end: '2022-12-26 23:30:00',
resourceId: 'r2',
title: 'I am not resizable',
resizable: false,
},
{
id: 3,
start: '2022-12-19 12:30:00',
end: '2022-12-20 23:30:00',
resourceId: 'r3',
title: 'I am not movable',
movable: false,
},
{
id: 4,
start: '2022-12-19 14:30:00',
end: '2022-12-20 23:30:00',
resourceId: 'r1',
title: 'I am not start-resizable',
startResizable: false,
},
{
id: 5,
start: '2022-12-19 15:30:00',
end: '2022-12-20 23:30:00',
resourceId: 'r2',
title: 'R2 has recurring tasks every week on Tuesday, Friday',
rrule: 'FREQ=WEEKLY;DTSTART=20221219T013000Z;BYDAY=TU,FR',
bgColor: '#f759ab',
},
]);
// ...
//3. render the scheduler component, mind that the Scheduler component should be placed in a DragDropContext(father or ancestor).
<Scheduler
schedulerData={schedulerData}
prevClick={this.prevClick}
nextClick={this.nextClick}
onSelectDate={this.onSelectDate}
onViewChange={this.onViewChange}
eventItemClick={this.eventClicked}
/>;- Clone this repository
- Retrieve dependencies:
npm installornpm i - Start:
npm run start - Open http://localhost:8080.
If you fail to execute the npm install command, remove the package-lock.json file and try again.
SchedulerData is the view model of Scheduler, we can modify it to control the view of the Scheduler.
constructor(date=dayjs().format(DATE_FORMAT), viewType = ViewType.Week,
showAgenda = false, isEventPerspective = false,
newConfig = undefined, newBehaviors=undefined
localeDayjs = undefined)dateis a string inYYYY-MM-DDformat, and is the initial date Scheduler will render. Take the date2022-12-20for example, Scheduler will render the time window of the week from2022-12-18to2022-12-24inViewType.Weekview type, and will render the time window of the2022-12month inViewType.Monthview type.viewTypeis the initial view type, now Scheduler supportsDay,Week,Month,Quarter,Year5 built-in view types, in addition Scheduler now supportsCustom,Custom1,Custom23 custom view types at the same time, in which you can control the time window yourself, refer to this example.viewType,showAgendaandisEventPerspectiveare a group which should be contained in the SchedulerData.config.views array, and they together decide which view should be rendered. WhenshowAgendaandisEventPerspectiveare bothfalse, Scheduler will render the resource view, refer to this example.showAgendais a bool value, if true, Scheduler will display the agenda view of current view type. Agenda view is read only.isEventPerspectiveis a bool value, if true, Scheduler will display the task view of current view type. In resource view, every slot(row) describes how many events a resource does in the time window, while in task view, every slot describes how many events a big task is divided into and who will make it done. Add agroupIdandgroupNameproperty to every event object, so that the events having the samegroupIdwill belong to the same big task and be rendered in the same slot in task view. IfgroupIdandgroupNameare not provided, SchedulerData will take theidas thegroupId, and take thetitleas thegroupName. See theeventsForTaskViewin the sample1.js for details.newConfigis a config object, used to override the default config fully or partly.newBehaviorsis a config object, used to override the default behaviors fully or partly.localeDayjsis a locale dayjs object, which is unified used in react-big-scheduler. If not provided, Scheduler will come with English(en, United States) locale strings.
setSchedulerLocale(preset);Used to set locale to the scheduler, it uses dayjs locales (List of supported locales) and it is loaded on demand.
preset will be locale imported from dayjs.
import * as dayjsLocale from 'dayjs/locale/pt-br';
setSchedulerLocale(dayjsLocale);By default, Scheduler comes with English(en, United States)
setCalendarPopoverLocale(lang);Used to set locale to the calendar popover. it uses antd locales (List of supported locales). By default, it comes with English(en, United States)
import * as antdLocale from 'antd/locale/pt_BR';
setCalendarPopoverLocale(antdLocale);refer this for the demo of the locale.
setResources(resources);Used to set the resources(the slots in resource view), make sure that there are no duplicated resource.id in the resources.
See the demo resources in the sample1.js.
setEvents(events);Used to set the events. the event array should be sorted in ascending order by event.start property.
See the demo events in the sample1.js.
If we use the task view, we'd better add the groupId and the groupName property to each event object, see the
eventsForTaskView in the sample1.js for details.
prev();Let the time window scroll to the left once. When SchedulerData,viewType is ViewType.Month, the time window will
scroll a month, when SchedulerData,viewType is ViewType.Week, the time window will scroll a week. SchedulerData.events
will be clear after calling this method.
next();Let the time window scroll to the right once. SchedulerData.events will be clear after calling this method.
setDate((date = dayjs().format(DATE_FORMAT)));Let the time window jump to the provided date directly. SchedulerData.events will be clear after calling this method.
setViewType((viewType = ViewType.Week), (showAgenda = false), (isEventPerspective = false));Tell SchedulerData to change current view, the viewType, showAgenda and isEventPerspective group should be
provided, and should be contained in the SchedulerData.config.views array. SchedulerData.events will be clear
after calling this method.
setEventGroups(eventGroups);Used to set the event groups(the slots in task view), make sure that there are no duplicated eventGroup.id in the eventGroups.
This method is optional, and is needed only when SchedulerData.eventGroupsAutoGenerated is false.
setEventGroupsAutoGenerated(autoGenerated);Tell SchedulerData to generate SchedulerData.eventGroups automatically or not. If true, SchedulerData will generate the event
groups(slots) automatically according to the event.groupId and 'event.groupName' automatically. If groupId and 'groupName' are
not provided, SchedulerData will take event.id and event.title instead.
setMinuteStep(minuteStep);Used to set minute step for daily view and refresh the render data.
toggleExpandStatus(slotId);Used to toggle slot's(and its children's) expand status.
getMinuteStepsInHour();Used to get minute steps in an hour, it equals 60 / SchedulerData.config.minuteStep.
addResource(resource);Add the resource to the SchedulerData.resources, make sure that resource.id is not duplicated. Refer
to this example.
addEventGroup(eventGroup);Add the eventGroup to the SchedulerData.eventGroups, make sure that eventGroup.id is not duplicated. Please note
that the eventGroup added may be override when SchedulerData.eventGroupsAutoGenerated is true and
SchedulerData.eventGroups is auto-generated.
addEvent(newEvent);Add the newEvent to the SchedulerData.events, make sure that newEvent.id is not duplicated. SchedulerData will
place the newEvent in the right index according to the newEvent.start property.
updateEventStart(event, newStart);Update the newStart to the event.start, newStart is a string in YYYY-MM-DD HH:mm:ss format(similarly hereinafter).
SchedulerData will replace the event in the right index according to the newStart value.
updateEventEnd(event, newEnd);Update the newEnd to the event.end.
moveEvent(event, newSlotId, newSlotName, newStart, newEnd);Update the newSlotId, newSlotName, newStart, newEnd of the event. In resource view, new slot is a resource,
while in task view, new slot is a event group. SchedulerData will replace the event in the right index according
to the newStart value.
removeEvent(event);Remove the given event from SchedeulerData.events.
removeEventById(eventId);Remove event from SchedeulerData.events by the given event id.
getSlots();Returns the slot array, SchedulerData.resources in resource view, SchedulerData.eventGroups in task view.
getSlotById(slotId);Returns the slot by slotId, returns undefined if not found.
getResourceById(resourceId);isEventInTimeWindow(eventStart, eventEnd, windowStart, windowEnd);Returns whether an event is in the time window or not, remind that eventStart, eventEnd, windowStart, windowEnd
are all dayjs | Date objects.
getViewDates();Returns an object with the startDate and endDate of the currently selected view ({ startDate: Dayjs, endDate: Dayjs }).
getViewStartDate();Returns a dayjs object with the startDate of the currently selected view.
getViewEndDate();Returns a dayjs object with the endDate of the currently selected view.
Locale support(Refer to this example for details.)
The locale string of resource name.
The locale string of task name.
The locale string of agenda view header.
The locale string of add more popover header format.
The locale string of event item popover date format.
The locale string of non-agenda view cell header format of day view type.
The locale string of non-agenda view cell header format of other view types.
Used to resolve the locale string of date label of Scheduler component.(Refer to the getDateLabel func for example)
SchedulerData.config(See the config file for details.)
The width of Scheduler. Scheduler uses responsive layout so schedulerWidth should be a percentage,
Scheduler in the responsive layout:
actual width of Scheduler = (SchedulerData.documentWidth - SchedulerData.config.besidesWidth) * SchedulerData.config.schedulerWidth
SchedulerData.documentWidth is the window width of browser (or the the parent width in case SchedulerData.config.responsiveByParent
and Scheduler component prop parentRef is passed) and will change automatically when resized.
When true, Scheduler resposiveness will not be determined by the window width of browser but instead by the
width of the of the parent (the parent ref must be passed to the Scheduler component prop named parentRef,
in case it is not passed resposiveness will fall back to being determined by the window width).
Meaning:
SchedulerData.documentWidth is the width of the parent and will change automatically when resized
The max height of Scheduler. If the desired height is bigger than the max height, the header row of Scheduler will be
frozen and vertical scroll bar will appear, but this won't happen when the max height is set to 0. Refer
to this example.
Height of Scheduler table header.
Width of the left Scheduler resource column in agenda view.
Max width of an event item in agenda view.
dayResourceTableWidth, weekResourceTableWidth, monthResourceTableWidth, yearResourceTableWidth, quarterResourceTableWidth
Width of the left Scheduler resource column in resource view and task view of different view types.
Width of Scheduler table cells in resource view and task view of different view types.
Max events count of a cell in resource view and task view of different view types. A '+N more' will appear when exceeded. Refer to this example.
Height of an event item in 3 views.
Line height of an event item in 3 views.
Min height of a slot in non-agenda views, default 0, means there is no min height.
Start hour rendered from in ViewType.Day in resource view and task view, default 0.
End hour rendered to in ViewType.Day in resource view and task view, default 23.
Default event item background color in 3 views, will be override if there is a bgColor property in event object.
Selected cells color in resource view and task view, cells are selectable only when creatable is true.
Color of non-working time head cells. Modify SchedulerData.behaviors.isNonWorkingTimeFunc to re-define non-working time.
Refer the isNonWorkingTime func in the behaviors.js.
Background color of non-working time head cells.
Background color of non-working time body cells.
Color of cell summary. Modify SchedulerData.behaviors.getSummaryFunc to display summary in a cell.
Refer the getSummary func in the behaviors.js.
Position of cell summary, supports SummaryPos.Top, SummaryPos.TopRight, SummaryPos.TopLeft, SummaryPos.Bottom,
SummaryPos.BottomRight and SummaryPos.BottomLeft.
Controls whether to resize the start of every event item in resource view and task view. If false, all item starts are
non-resizable, if true, all item starts are resizable except those who have a resizable or startResizable
property and its value is false.
Controls whether to resize the end of every event item in resource view and task view. If false, all item ends are
non-resizable, if true, all item ends are resizable except those who have a resizable or endResizable
property and its value is false.
Controls whether to move every event item in resource view and task view. If false, all items are
non-movable, if true, all items are movable except those who have a movable property and its value is false.
Controls whether to create new event item in resource view and task view.
Controls whether to cross-slot move an event item in resource view and task view. If false, the slotId and slotName
won't change in the moveEvent method. Refer to this example.
Controls whether to check conflicts when creating, resizing or moving an event item in resource view and task view. If
true, Scheduler will call the conflictOccurred function if given. Refer to
this example.
Controls Scheduler whether to scroll to special dayjs automatically when the time window contains special dayjs. If true, Scheduler
horizontal bar will scroll to special dayjs after calling setScrollToSpecialDayjs(true) to SchedulerData. Use SchedulerData.behaviors.getScrollSpecialDayjsFunc
to tell Scheduler what time the special dayjs is.
Controls Scheduler whether to display event item popover when moving mouse on an event item, default true.
Controls Scheduler event item popover trigger, default hover.
Controls Scheduler whether to display event item popover when moving mouse on an event item, default true.
Controls Scheduler event item popover placement ('topLeftMousePosition' | 'bottomLeftMousePosition' | 'topRightMousePosition' | 'bottomRightMousePosition' | 'top' | 'left' | 'right' | 'bottom' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom'), default bottomLeft.
Controls Scheduler event item popover width. Should be taken into account when you set eventItemPopoverPlacement to one of the ...MousePosition options and you set your own event item popover by setting eventItemPopoverTemplateResolver as eventItemPopoverWidth is used to determine when the event item popover content goes off the screen so the popover can be adjusted accordingly. Defaults to 300.
Controls Scheduler whether to display calendar popover when clicking on a date label in header, default true.
Controls Scheduler whether to support recurring event, refer to this feature request, default true.
If true, SchedulerData will filter out those template events who has a rrule string property in setEvents method,
generate the recurring events in the time window, and insert them into the event array in the right orders. The recurring events
generated from the same template event, all have a new id like ${templateEvent.id}-${number}, and have a recurringEventId
property with the value templateEvent.id.
Controls Scheduler whether to display header, default true.
Controls Scheduler whether to display resource view, default true.
Controls Scheduler whether to display weekends in non-agenda view, default true.
Controls Scheduler whether to move events(only DnDTypes.EVENT type) relatively or absolutely, default true, means relatively.
Minute step for day view type in non-agenda view, can be 10, 12, 15, 20, 30, 60, etc, default 30.
Array of view that Scheduler will support.
Controls whether the dragAndDrop funcionality is enabled. If false there's no need for the withDnDContext wrapper function.
SchedulerData.behaviors(See the behaviors.js for details.)
getEventTextFunc(schedulerData, event);Method that defines the text displayed in the event.
isNonWorkingTimeFunc(schedulerData, time);Method that defines non-working time.
getSummary(schedulerData, headerEvents, slotId, slotName, headerStart, headerEnd);Method that defines the summary text displayed in the Scheduler cells.Refer to this example.
getCustomDate(schedulerData, num, (date = undefined));Method that controls the start and end of time window when current view type is Custom, Custom1 or Custom2.Refer to this example.
getNonAgendaViewBodyCellBgColor(schedulerData, slotId, header);Method that sets the background color of cells dynamically.
getScrollSpecialDayjs(schedulerData, startDayjs, endDayjs);Method that defines the special dayjs Scheduler will scroll to automatically, when the time window contains that dayjs.
schedulerData: PropTypes.object.isRequired;View model of the Scheduler component, provides data.
parentRef: PropTypes.object;ref of the component that is the parent of the Scheduler component
prevClick: PropTypes.func.isRequired;
prevClick(schedulerData);Callback function fired when the left point bracket '<' is clicked.
nextClick: PropTypes.func.isRequired;
nextClick(schedulerData);Callback function fired when the right point bracket '>' is clicked.
onViewChange: PropTypes.func.isRequired;
onViewChange(schedulerData, view);Callback function fired when the Scheduler view changed. view is a json such as { viewType: ViewType.Month,
showAgenda: true, isEventPerspective: false}.
onSelectDate: PropTypes.func.isRequired;
onSelectDate(schedulerData, date);Callback function fired when a new date is selected. date is the new selected data, a string in YYYY-MM-DD format.
eventItemClick: PropTypes.func;
eventItemClick(schedulerData, event);Callback function fired when you click an event item.
updateEventStart: PropTypes.func;
updateEventStart(schedulerData, event, newStart);Callback function fired when resizing the start of the event, newStart is a string in YYYY-MM-DD HH:mm:ss format.
updateEventEnd: PropTypes.func;
updateEventEnd(schedulerData, event, newEnd);Callback function fired when resizing the end of the event, newEnd is a string in YYYY-MM-DD HH:mm:ss format.
moveEvent: PropTypes.func;
moveEvent((schedulerData, event, slotId, slotName, newStart, newEnd));Callback function fired when moving the event. slotId, slotName are the new id and name of the slot moving into,
but they won't change if the SchedulerData.config.crossResourceMove is false. newStart, newEnd are the new beginning
and ending of the event.
newEvent: PropTypes.func;
newEvent(schedulerData, slotId, slotName, start, end, type, item);Callback function fired when creating a new event, or dragging an external item and dropping it into the resource view or task
view. slotId and slotName are the slot creating in or dropping into, start, end are the beginning and ending of the
event. If it's a drag&drop operation, the type is the DnDType of DnDSource registered to Scheduler, and the item is the
external item.
leftCustomHeader: PropTypes.object;
rightCustomHeader: PropTypes.object;Component you need to put in the Scheduler header, it could be a div or a react component. Refer to this example.
conflictOccurred: PropTypes.func;
conflictOccurred(schedulerData, action, event, type, slotId, slotName, start, end);Callback function fired when there is a conflict. This could happen when creating, resizing or moving an event, and when
SchedulerData.config.checkConflict is true.
eventItemTemplateResolver: PropTypes.func;
eventItemTemplateResolver(schedulerData, event, bgColor, isStart, isEnd, mustAddCssClass, mustBeHeight, agendaMaxEventWidth);Use this function, you can customize the event style. Refer to this example.
eventItemPopoverTemplateResolver: PropTypes.func;
eventItemPopoverTemplateResolver(schedulerData, eventItem, title, start, end, statusColor);Use this function, you can customize the event's popover style. Refer to this example.
slotItemTemplateResolver: PropTypes.func;
slotItemTemplateResolver(schedulerData, slot, slotClickedFunc, width, clsName);Use this function, you can customize the left slot style.
nonAgendaCellHeaderTemplateResolver: PropTypes.func;
nonAgendaCellHeaderTemplateResolver(schedulerData, item, formattedDateItems, style);Use this function, you can customize the table header cell style. Refer to this example.
onScrollLeft: PropTypes.func;
onScrollLeft(schedulerData, schedulerContent, maxScrollLeft);
onScrollRight: PropTypes.func;
onScrollRight(schedulerData, schedulerContent, maxScrollLeft);Callback function fired when the scheduler content div scrolls to leftmost or rightmost. Refer to this example.
onScrollTop: PropTypes.func;
onScrollTop(schedulerData, schedulerContent, maxScrollTop);
onScrollBottom: PropTypes.func;
onScrollBottom(schedulerData, schedulerContent, maxScrollTop);Callback function fired when the scheduler content div scrolls to topmost or bottommost. Refer to this example.
slotClickedFunc: PropTypes.func;If it's set, slots will be clickable, and will fire this function when a slot is clicked. Refer to this example.
dndSources: PropTypes.array;DnDSource array that registered to Scheduler. Use DnDSource, we can simplify the drag and drop coding in React-Big-Scheduler. Refer to this example.
onSetAddMoreState: PropTypes.func;
onSetAddMoreState(newState);Callback function fired when a '+N more' is clicked, is used to control the visibility and the position of the AddMorePopover.
newState is a json such as {headerItem: headerItem, left: 20, top: 20, height: 100}. Refer
to this example.
subtitleGetter: PropTypes.func;
subtitleGetter(schedulerData, event);Use this function, you can display a subtitle in the EventItemPopover.
viewEventClick: PropTypes.func;
viewEventClick(schedulerData, event);Callback function fired when you click one operation link in the EventItemPopover. The operation link won't appear if this
function isn't set.
viewEventText: PropTypes.string;Text of one operation link in the EventItemPopover. The operation link won't appear if this text isn't set.
viewEvent2Click: PropTypes.func;
viewEvent2Click(schedulerData, event);Callback function fired when you click the other operation link in the EventItemPopover. The other operation link won't
appear if this function isn't set.
viewEvent2Text: PropTypes.string;Text of the other operation link in the EventItemPopover. The other operation link won't appear if this text isn't set.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent