Vue 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.

Backend API

<template> <DxScheduler time-zone="America/Los_Angeles" :data-source="data" :views="views" current-view="workWeek" :current-date="currentDate" :start-day-hour="9" :end-day-hour="19" :height="600" ref="schedulerRef" > <DxResource :data-source="assignees" field-expr="assigneeId" label="Assignee" :allow-multiple="true" icon="user" /> <DxToolbar> <DxItem name="today"/> <DxItem name="dateNavigator"/> <DxItem location="before" locate-in-menu="auto" widget="dxButton" :options="newEventButtonOptions" /> <DxItem location="before" locate-in-menu="auto" template="assigneesTemplate" /> <DxItem location="after" locate-in-menu="auto" name="viewSwitcher" /> </DxToolbar> <template #assigneesTemplate> <DxSelectBox placeholder="Select Employee" :items="assignees" :show-clear-button="true" display-expr="text" value-expr="id" :input-attr="{ 'aria-label': 'Select Employee' }" :width="200" :value="assigneesFilterValue" @value-changed="onAssigneesFilterChange" /> </template> </DxScheduler> </template> <script setup lang="ts"> import { ref } from 'vue'; import { DxScheduler, DxResource, DxToolbar, DxItem, } from 'devextreme-vue/scheduler'; import type { DxSchedulerTypes } from 'devextreme-vue/scheduler'; import { DxSelectBox, type DxSelectBoxTypes } from 'devextreme-vue/select-box'; import type { DataSource } from 'devextreme-vue/common/data'; import { assignees, currentDate, data } from './data.ts'; const MS_IN_HOUR = 60 * 1000; const views: DxSchedulerTypes.ViewType[] = ['day', 'week', 'workWeek', 'month']; const assigneesFilterValue = ref(undefined); const schedulerRef = ref<DxScheduler | null>(null); const onAppointmentAdd = () => { const scheduler = schedulerRef.value?.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 = scheduler.option('cellDuration') as number; 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 newEventButtonOptions = { icon: 'plus', text: 'New Appointment', stylingMode: 'outlined', type: 'normal', onClick: () => { onAppointmentAdd(); }, }; function onAssigneesFilterChange(event: DxSelectBoxTypes.ValueChangedEvent) { const scheduler = schedulerRef.value?.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); assigneesFilterValue.value = event.value; } </script>

import type { DxSchedulerTypes } from 'devextreme-vue/scheduler'; type CustomAppointment = DxSchedulerTypes.Appointment & { assigneeId: 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: CustomAppointment[] = [ { 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 = [ { text: 'Samantha Bright', id: 1, }, { text: 'John Heart', id: 2, }, { text: 'Todd Hoffman', id: 3, }, { text: 'Sandra Johnson', id: 4, }, ];

import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#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" /> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"> </div> </div> <script src="bundles/vendor/vue.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[].template to implement custom controls.

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