React Scheduler - Timetable
The Scheduler UI component allows you to customize its timetable. You can specify the time period and a single cell's duration via the startDayHour, endDayHour, and cellDuration properties. Using the firstDayOfWeek property, you can define the weekday that is shown first.
jQuery
$(function() { $("#schedulerContainer").dxScheduler({ dataSource: [{ text: "Website Re-Design Plan", startDate: new Date("2016-04-25T09:30:00.000Z"), endDate: new Date("2016-04-25T11:30:00.000Z") }, { text: "Book Flights to San Fran for Sales Trip", startDate: new Date("2016-04-25T12:00:00.000Z"), endDate: new Date("2016-04-25T13:00:00.000Z") }, // ... ], currentDate: new Date(2016, 4, 25), startDayHour: 8, endDayHour: 19, cellDuration: 60, firstDayOfWeek: 1 }); });
Angular
<dx-scheduler [dataSource]="schedulerData" [currentDate]="currentDate" [startDayHour]="8" [endDayHour]="19" [cellDuration]="60" [firstDayOfWeek]="1"> </dx-scheduler>
import { DxSchedulerModule } from "devextreme-angular"; // ... export class AppComponent { schedulerData = [{ text: "Website Re-Design Plan", startDate: new Date("2016-04-25T09:30:00.000Z"), endDate: new Date("2016-04-25T11:30:00.000Z") }, { text: "Book Flights to San Fran for Sales Trip", startDate: new Date("2016-04-25T12:00:00.000Z"), endDate: new Date("2016-04-25T13:00:00.000Z") }, // ... ]; currentDate = new Date(2016, 4, 25); } @NgModule({ imports: [ // ... DxSchedulerModule ], // ... })
Vue
<template> <DxScheduler :data-source="dataSource" :current-date="currentDate" :start-day-hour="8" :end-day-hour="19" :cell-duration="60" :first-day-of-week="1" /> </template> <script> import 'devextreme/dist/css/dx.light.css'; import { DxScheduler } from 'devextreme-vue/scheduler'; export default { components: { DxScheduler }, data() { return { dataSource: [{ text: 'Website Re-Design Plan', startDate: new Date("2016-04-25T09:30:00.000Z"), endDate: new Date("2016-04-25T11:30:00.000Z") }, { text: 'Book Flights to San Fran for Sales Trip', startDate: new Date("2016-04-25T12:00:00.000Z"), endDate: new Date("2016-04-25T13:00:00.000Z") }, // ... ], currentDate: new Date(2016, 4, 25) }; } } </script>
React
import React from 'react'; import 'devextreme/dist/css/dx.light.css'; import { Scheduler } from 'devextreme-react/scheduler'; const dataSource = [{ text: 'Website Re-Design Plan', startDate: new Date("2016-04-25T09:30:00.000Z"), endDate: new Date("2016-04-25T11:30:00.000Z") }, { text: 'Book Flights to San Fran for Sales Trip', startDate: new Date("2016-04-25T12:00:00.000Z"), endDate: new Date("2016-04-25T13:00:00.000Z") }, // ... ]; const currentDate = new Date(2016, 4, 25); class App extends React.Component { render() { return ( <Scheduler dataSource={dataSource} defaultCurrentDate={currentDate} startDayHour={8} endDayHour={19} cellDuration={60} firstDayOfWeek={1} /> ); } } export default App;
You can also adjust cells' size in the table and around it using the DevExtreme CSS classes. For example, the .dx-scheduler-cell-sizes-horizontal
and .dx-scheduler-cell-sizes-vertical
classes specify the cells' width and height, respectively. These classes apply if the crossScrollingEnabled property is set to true.
#yourSchedulerID .dx-scheduler-cell-sizes-horizontal { width: 200px; } #yourSchedulerID .dx-scheduler-cell-sizes-vertical { height: 200px; }
For a more detailed customization, define custom templates for cells, time scales, and date scales. DevExtreme provides the dxTemplate markup component for Angular, AngularJS and Knockout apps. The following code shows how to use dxTemplate to define templates for timetable parts:
Angular
<dx-scheduler [dataSource]="schedulerData" [currentDate]="currentDate" [showAllDayPanel]="false" currentView="week" dataCellTemplate="dataCellTemplate" dateCellTemplate="dateCellTemplate" timeCellTemplate="timeCellTemplate"> <div *dxTemplate="let data of 'dataCellTemplate'"> <div style="width: 100%; height: 40px; background-color: rgba(86, 202, 133, 0.1);"></div> </div> <div *dxTemplate="let date of 'dateCellTemplate'"> <b style="color: green">{{date.text}}</b> </div> <div *dxTemplate="let time of 'timeCellTemplate'"> <i style="color: green">{{time.text}}</i> </div> </dx-scheduler>
import { DxSchedulerModule } from "devextreme-angular"; // ... export class AppComponent { schedulerData = [{ text: "His Girl Friday", startDate: new Date("2016-04-24T09:10:00.000Z"), endDate: new Date("2016-04-24T11:20:00.000Z") }, { text: "Royal Wedding", startDate: new Date("2016-04-24T10:05:00.000Z"), endDate: new Date("2016-04-24T11:30:00.000Z") }, // ... ]; currentDate = new Date(2016, 4, 24); } @NgModule({ imports: [ // ... DxSchedulerModule ], // ... })
AngularJS
<div ng-controller="DemoController"> <div dx-scheduler="{ dataSource: schedulerData, currentDate: currentDate, showAllDayPanel: false, currentView: 'week', dataCellTemplate: 'dataCellTemplate', dateCellTemplate: 'dateCellTemplate', timeCellTemplate: 'timeCellTemplate' }" dx-item-alias="item"> <div data-options="dxTemplate: { name: 'dataCellTemplate' }"> <div style="width: 100%; height: 40px; background-color: rgba(86, 202, 133, 0.1);"></div> </div> <div data-options="dxTemplate: { name: 'dateCellTemplate' }"> <b style="color: green">{{item.text}}</b> </div> <div data-options="dxTemplate: { name: 'timeCellTemplate' }"> <i style="color: green">{{item.text}}</i> </div> </div> </div>
angular.module('DemoApp', ['dx']) .controller('DemoController', function DemoController($scope) { $scope.schedulerData = [{ text: "His Girl Friday", startDate: new Date("2016-04-24T09:10:00.000Z"), endDate: new Date("2016-04-24T11:20:00.000Z") }, { text: "Royal Wedding", startDate: new Date("2016-04-24T10:05:00.000Z"), endDate: new Date("2016-04-24T11:30:00.000Z") }, // ... ]; $scope.currentDate = new Date(2016, 4, 24); });
dx-item-alias
directive specifies the variable that is used to access the item object.Knockout
<div data-bind="dxScheduler: { dataSource: schedulerData, currentDate: currentDate, showAllDayPanel: false, currentView: 'week', dataCellTemplate: 'dataCellTemplate', dateCellTemplate: 'dateCellTemplate', timeCellTemplate: 'timeCellTemplate' }"> <div data-options="dxTemplate: { name: 'dataCellTemplate' }"> <div style="width: 100%; height: 40px; background-color: rgba(86, 202, 133, 0.1);"></div> </div> <div data-options="dxTemplate: { name: 'dateCellTemplate' }"> <b style="color: green" data-bind="text: text"></b> </div> <div data-options="dxTemplate: { name: 'timeCellTemplate' }"> <i style="color: green" data-bind="text: text"></i> </div> </div>
var viewModel= { schedulerData: [{ movie: "His Girl Friday", price: 5, startDate: new Date("2016-04-24T09:10:00.000Z"), endDate: new Date("2016-04-24T11:20:00.000Z") }, { movie: "Royal Wedding", price: 10, startDate: new Date("2016-04-24T10:05:00.000Z"), endDate: new Date("2016-04-24T11:30:00.000Z") }, // ... ], currentDate: new Date(2016, 4, 24) }; ko.applyBindings(viewModel);
Vue
<template> <DxScheduler :data-source="schedulerData" :current-date="currentDate" :show-all-day-panel="false" data-cell-template="dataCellTemplate" date-cell-template="dateCellTemplate" time-cell-template="timeCellTemplate" current-view="week" > <template #dataCellTemplate> <div v-bind:style="styles"></div> </template> <template #dateCellTemplate="{ data }"> <b v-bind:style="{ color: 'green' }">{{data.text}}</b> </template> <template #timeCellTemplate="{ data }"> <b v-bind:style="{ color: 'green' }">{{data.text}}</b> </template> </DxScheduler> </template> <script> import 'devextreme/dist/css/dx.light.css'; import { DxScheduler } from 'devextreme-vue/scheduler'; export default { components: { DxScheduler }, data() { return { currentDate: new Date(2016, 4, 24), styles: { 'background-color': 'rgba(86, 202, 133, 0.1)', width: '100%', height: '40px' } }; } } </script>
React
import React from 'react'; import 'devextreme/dist/css/dx.light.css'; import { Scheduler } from 'devextreme-react/scheduler'; const currentDate = new Date(2016, 4, 24); class App extends React.Component { render() { return ( <Scheduler dataSource={schedulerData} defaultCurrentDate={currentDate} showAllDayPanel={false} dataCellRender={this.renderDataCell} dateCellRender={this.renderDateCell} timeCellRender={this.renderTimeCell} defaultCurrentView="week" /> ); } renderDataCell(data, index) { return <div style={{ width: '100%', height: 40, backgroundColor: 'rgba(86, 202, 133, 0.1)' }}></div>; } renderDateCell(data, index) { return <b style={{ color: 'green', fontWeight: 'bold' }}><p>{data.text}</p></b>; } renderTimeCell(data, index) { return <b style={{ color: 'green', fontWeight: 'bold' }}><p>{data.text}</p></b>; } } export default App;
If you use jQuery alone, use DOM manipulation methods to combine the HTML markup for time scales and date scales. To apply this markup, use the timeCellTemplate, dateCellTemplate and dataCellTemplate callback functions as shown in the following code:
var schedulerData = [{ text: "His Girl Friday", startDate: new Date("2016-04-24T09:10:00.000Z"), endDate: new Date("2016-04-24T11:20:00.000Z") }, { text: "Royal Wedding", startDate: new Date("2016-04-24T10:05:00.000Z"), endDate: new Date("2016-04-24T11:30:00.000Z") }, // ... ]; $(function () { $("#schedulerContainer").dxScheduler({ dataSource: schedulerData, currentDate: new Date(2016, 4, 24), showAllDayPanel: false, currentView: 'week', dataCellTemplate: function(data, index, element) { return $("<div />") .css('width', '100%') .css('height', '40px') .css('background-color', 'rgba(86, 202, 133, 0.1)'); }, dateCellTemplate: function(data, index, element) { element.text(data.text) .css('color', 'green') .css('font-weight', 'bold'); }, timeCellTemplate: function(data, index, element) { element.text(data.text) .css('color', 'green') .css('font-style', 'italic'); } }); });
You can also use a 3rd-party template engine to customize UI component appearance. See the 3rd-Party Template Engines article for more information.
See Also
If you have technical questions, please create a support ticket in the DevExpress Support Center.