React Scheduler - Toolbar

The DevExtreme Scheduler ships with a customizable toolbar UI element. You can populate the toolbar with predefined and custom items—in any display order. This demo adds the "today" predefined control and two DevExtreme components to the toolbar.

TS JS

Backend API

import React, { useCallback, useMemo, useRef, useState } from 'react'; import { Scheduler, Resource, Toolbar, Item } from 'devextreme-react/scheduler'; import { SelectBox } from 'devextreme-react/select-box'; import type { DataSource } from 'devextreme-react/common/data'; import type { SchedulerRef, SchedulerTypes } from 'devextreme-react/scheduler'; import type { SelectBoxTypes } from 'devextreme-react/select-box'; import { assignees, data, currentDate } from './data.ts'; const views: SchedulerTypes.ViewType[] = ['day', 'week', 'workWeek', 'month']; const selectBoxPlaceholder = 'Select Employee'; const inputAttr = { 'aria-label': selectBoxPlaceholder }; const MS_IN_HOUR = 60 * 1000; const App = () => { const schedulerRef = useRef<SchedulerRef>(null); const [assigneesFilterValue, setAssigneesFilterValue] = useState<number>(); const onAssigneesFilterChange = useCallback((event: SelectBoxTypes.ValueChangedEvent) => { const scheduler = schedulerRef.current?.instance?.(); if (!scheduler) { return; } const dataSource = scheduler.option('dataSource') as DataSource; const filter = event.value ? ['assigneeId', 'contains', event.value] : null; dataSource.filter(filter); scheduler.option('dataSource', dataSource); setAssigneesFilterValue(event.value); }, []); const onAppointmentAdd = useCallback(() => { const scheduler = schedulerRef.current?.instance?.(); if (!scheduler) { return; } const selected = scheduler.option('selectedCellData') ?? []; if (selected.length) { const firstSelected = selected[0]; const lastSelected = selected.at(-1); scheduler.showAppointmentPopup({ ...firstSelected.groups, allDay: firstSelected.allDay, startDate: new Date(firstSelected.startDateUTC), endDate: new Date(lastSelected.endDateUTC), }, true); return; } const currentDate = scheduler.option('currentDate'); const cellDuration = Number(scheduler.option('cellDuration')); const cellDurationMs = cellDuration * MS_IN_HOUR; const currentTime = new Date(currentDate as Date).getTime(); const roundTime = Math.round(currentTime / cellDurationMs) * cellDurationMs; scheduler.showAppointmentPopup({ startDate: new Date(roundTime), endDate: new Date(roundTime + cellDurationMs), }, true); }, []); const toggleButtonOptions = useMemo(() => ({ icon: 'plus', text: 'New Appointment', stylingMode: 'outlined', type: 'normal', onClick() { onAppointmentAdd(); }, }), [onAppointmentAdd]); return ( <Scheduler timeZone="America/Los_Angeles" dataSource={data} views={views} defaultCurrentView="workWeek" defaultCurrentDate={currentDate} startDayHour={9} endDayHour={19} height={600} ref={schedulerRef} > <Resource dataSource={assignees} allowMultiple={true} fieldExpr="assigneeId" label="Assignee" icon="user" /> <Toolbar> <Item name="today" /> <Item name="dateNavigator" /> <Item location="before" locateInMenu="auto" widget="dxButton" options={toggleButtonOptions} /> <Item location="before" locateInMenu="auto"> <SelectBox placeholder={selectBoxPlaceholder} items={assignees} showClearButton={true} displayExpr="text" valueExpr="id" inputAttr={inputAttr} width={200} value={assigneesFilterValue} onValueChanged={onAssigneesFilterChange} /> </Item> <Item location="after" locateInMenu="auto" name="viewSwitcher" /> </Toolbar> </Scheduler> ); }; export default App;

import React, { useCallback, useMemo, useRef, useState, } from 'react'; import { Scheduler, Resource, Toolbar, Item, } from 'devextreme-react/scheduler'; import { SelectBox } from 'devextreme-react/select-box'; import { assignees, data, currentDate } from './data.js'; const views = ['day', 'week', 'workWeek', 'month']; const selectBoxPlaceholder = 'Select Employee'; const inputAttr = { 'aria-label': selectBoxPlaceholder }; const MS_IN_HOUR = 60 * 1000; const App = () => { const schedulerRef = useRef(null); const [assigneesFilterValue, setAssigneesFilterValue] = useState(); const onAssigneesFilterChange = useCallback((event) => { const scheduler = schedulerRef.current?.instance?.(); if (!scheduler) { return; } const dataSource = scheduler.option('dataSource'); const filter = event.value ? ['assigneeId', 'contains', event.value] : null; dataSource.filter(filter); scheduler.option('dataSource', dataSource); setAssigneesFilterValue(event.value); }, []); const onAppointmentAdd = useCallback(() => { const scheduler = schedulerRef.current?.instance?.(); if (!scheduler) { return; } const selected = scheduler.option('selectedCellData') ?? []; if (selected.length) { const firstSelected = selected[0]; const lastSelected = selected.at(-1); scheduler.showAppointmentPopup( { ...firstSelected.groups, allDay: firstSelected.allDay, startDate: new Date(firstSelected.startDateUTC), endDate: new Date(lastSelected.endDateUTC), }, true, ); return; } const currentDate = scheduler.option('currentDate'); const cellDuration = Number(scheduler.option('cellDuration')); const cellDurationMs = cellDuration * MS_IN_HOUR; const currentTime = new Date(currentDate).getTime(); const roundTime = Math.round(currentTime / cellDurationMs) * cellDurationMs; scheduler.showAppointmentPopup( { startDate: new Date(roundTime), endDate: new Date(roundTime + cellDurationMs), }, true, ); }, []); const toggleButtonOptions = useMemo( () => ({ icon: 'plus', text: 'New Appointment', stylingMode: 'outlined', type: 'normal', onClick() { onAppointmentAdd(); }, }), [onAppointmentAdd], ); return ( <Scheduler timeZone="America/Los_Angeles" dataSource={data} views={views} defaultCurrentView="workWeek" defaultCurrentDate={currentDate} startDayHour={9} endDayHour={19} height={600} ref={schedulerRef} > <Resource dataSource={assignees} allowMultiple={true} fieldExpr="assigneeId" label="Assignee" icon="user" /> <Toolbar> <Item name="today" /> <Item name="dateNavigator" /> <Item location="before" locateInMenu="auto" widget="dxButton" options={toggleButtonOptions} /> <Item location="before" locateInMenu="auto" > <SelectBox placeholder={selectBoxPlaceholder} items={assignees} showClearButton={true} displayExpr="text" valueExpr="id" inputAttr={inputAttr} width={200} value={assigneesFilterValue} onValueChanged={onAssigneesFilterChange} /> </Item> <Item location="after" locateInMenu="auto" name="viewSwitcher" /> </Toolbar> </Scheduler> ); }; export default App;

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import type { SchedulerTypes } from 'devextreme-react/scheduler'; type Appointment = SchedulerTypes.Appointment & { assigneeId: number[]; }; export interface Assignee { text: string; id: number; } const addDays = (date: Date, days: number) => new Date(new Date(date).setUTCDate(date.getUTCDate() + days)); const now = new Date(new Date().setUTCHours(0, 0, 0, 0)); const startOfTheWeek = addDays(now, -now.getUTCDay()); export const currentDate = new Date(2025, 5, 10); const currentStartOfTheWeek = addDays(currentDate, -currentDate.getUTCDay()); export const data: Appointment[] = [ { text: 'Website Re-Design Plan', assigneeId: [4], startDate: new Date(addDays(startOfTheWeek, 1).setUTCHours(16, 30)), endDate: new Date(addDays(startOfTheWeek, 1).setUTCHours(18, 30)), }, { text: 'Book Flights to San Fran for Sales Trip', assigneeId: [2], startDate: new Date(addDays(startOfTheWeek, 2).setUTCHours(19)), endDate: new Date(addDays(startOfTheWeek, 2).setUTCHours(20)), allDay: true, }, { text: 'Install New Router in Dev Room', assigneeId: [1], startDate: new Date(addDays(startOfTheWeek, 2).setUTCHours(21, 30)), endDate: new Date(addDays(startOfTheWeek, 2).setUTCHours(22, 30)), }, { text: 'Approve Personal Computer Upgrade Plan', assigneeId: [3], startDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(17)), endDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(18)), }, { text: 'Final Budget Review', assigneeId: [1], startDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(19)), endDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(20, 35)), }, { text: 'New Brochures', assigneeId: [4], startDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(21, 30)), endDate: new Date(addDays(startOfTheWeek, 3).setUTCHours(22, 45)), }, { text: 'Install New Database', assigneeId: [2], startDate: new Date(addDays(startOfTheWeek, 4).setUTCHours(16, 45)), endDate: new Date(addDays(startOfTheWeek, 4).setUTCHours(18, 15)), }, { text: 'Approve New Online Marketing Strategy', assigneeId: [4], startDate: new Date(addDays(currentStartOfTheWeek, 1).setUTCHours(19)), endDate: new Date(addDays(currentStartOfTheWeek, 1).setUTCHours(21)), }, { text: 'Upgrade Personal Computers', assigneeId: [2], startDate: new Date(addDays(currentStartOfTheWeek, 1).setUTCHours(22, 15)), endDate: new Date(addDays(currentStartOfTheWeek, 1).setUTCHours(23, 30)), }, { text: 'Customer Workshop', assigneeId: [3], startDate: new Date(addDays(startOfTheWeek, 5).setUTCHours(18)), endDate: new Date(addDays(startOfTheWeek, 5).setUTCHours(19)), recurrenceRule: 'FREQ=WEEKLY;INTERVAL=1', }, { text: 'Prepare 2021 Marketing Plan', assigneeId: [1], startDate: new Date(addDays(currentStartOfTheWeek, 2).setUTCHours(18)), endDate: new Date(addDays(currentStartOfTheWeek, 2).setUTCHours(20, 30)), }, { text: 'Brochure Design Review', assigneeId: [4], startDate: new Date(addDays(startOfTheWeek, 5).setUTCHours(21)), endDate: new Date(addDays(startOfTheWeek, 5).setUTCHours(22, 30)), }, { text: 'Create Icons for Website', assigneeId: [3], startDate: new Date(addDays(currentStartOfTheWeek, 3).setUTCHours(17)), endDate: new Date(addDays(currentStartOfTheWeek, 3).setUTCHours(18, 30)), }, { text: 'Upgrade Server Hardware', assigneeId: [4], startDate: new Date(addDays(currentStartOfTheWeek, 2).setUTCHours(16)), endDate: new Date(addDays(currentStartOfTheWeek, 2).setUTCHours(17, 30)), }, { text: 'Submit New Website Design', assigneeId: [1], startDate: new Date(addDays(currentStartOfTheWeek, 5).setUTCHours(23, 30)), endDate: new Date(addDays(currentStartOfTheWeek, 6).setUTCHours(1)), }, { text: 'Launch New Website', assigneeId: [2], startDate: new Date(addDays(currentStartOfTheWeek, 4).setUTCHours(19)), endDate: new Date(addDays(currentStartOfTheWeek, 4).setUTCHours(21)), }, ]; export const assignees: Assignee[] = [ { text: 'Samantha Bright', id: 1, }, { text: 'John Heart', id: 2, }, { text: 'Todd Hoffman', id: 3, }, { text: 'Sandra Johnson', id: 4, }, ];

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> <script src="bundles/vendor/react.vendor.js"></script> <script src="./bundle.js"></script> </body> </html>

To customize the Scheduler toolbar in your DevExtreme-powered app, add items to the toolbar.items[] array. DevExtreme Scheduler supports the following toolbar item types:

Predefined Controls
- "dateNavigator"
  Displays a ButtonGroup component with next/previous buttons and a date interval button that invokes a dropdown calendar. Define options.items to customize the control. You can add new buttons, and specify button availability/order.
- "viewSwitcher"
  Switches between view types (day, week, month, and others).
- "today"
  A "Today" button (navigates to the current date).
DevExtreme Components
You can configure a DevExtreme component within a toolbar item element. In this demo, we extended the toolbar with a Button and SelectBox.
Custom Controls
Specify items[].render or component to implement custom controls.

The default Scheduler toolbar displays "dateNavigator" and "viewSwitcher" predefined controls.