JavaScript/jQuery Scheduler Methods
addAppointment(appointment)
The appointment; should have the same structure as objects in the dataSource.
See Also
- Call Methods: Angular | Vue | React | jQuery | AngularJS | Knockout
- onAppointmentAdding
- onAppointmentAdded
beginUpdate()
Prevents the UI component from refreshing until the endUpdate() method is called.
The beginUpdate() and endUpdate() methods prevent the UI component from excessive updates when you are changing multiple UI component settings at once. After the beginUpdate() method is called, the UI component does not update its UI until the endUpdate() method is called.
See Also
defaultOptions(rule)
defaultOptions is a static method that the UI component class supports. The following code demonstrates how to specify default properties for all instances of the Scheduler UI component in an application executed on the desktop.
jQuery
DevExpress.ui.dxScheduler.defaultOptions({ device: { deviceType: "desktop" }, options: { // Here go the Scheduler properties } });
Angular
import Scheduler from "devextreme/ui/scheduler"; // ... export class AppComponent { constructor () { Scheduler.defaultOptions({ device: { deviceType: "desktop" }, options: { // Here go the Scheduler properties } }); } }
Vue
<template> <div> <DxScheduler id="scheduler1" /> <DxScheduler id="scheduler2" /> </div> </template> <script> import DxScheduler from "devextreme-vue/scheduler"; import Scheduler from "devextreme/ui/scheduler"; Scheduler.defaultOptions({ device: { deviceType: "desktop" }, options: { // Here go the Scheduler properties } }); export default { components: { DxScheduler } } </script>
React
import React, {useEffect} from "react"; import dxScheduler from "devextreme/ui/scheduler"; import Scheduler from "devextreme-react/scheduler"; export default function App() { useEffect(() => { dxScheduler.defaultOptions({ device: { deviceType: "desktop" }, options: { // Here go the Scheduler properties } }) }); return ( <div> <Scheduler id="scheduler1" /> <Scheduler id="scheduler2" /> </div> ) }
deleteAppointment(appointment)
An appointment object from the dataSource.
If you delete a recurring appointment from the data source, all its occurrences are also deleted from the timetable:
jQuery
$(function() { var appointments = [{ text: "Website Re-Design Plan", startDate: new Date(2018, 4, 25, 9, 00), endDate: new Date(2018, 4, 25, 9, 30), recurrenceRule: "FREQ=DAILY;COUNT=10" }, // ... ]; var scheduler = $("#schedulerContainer").dxScheduler({ dataSource: appointments, currentDate: new Date(2018, 4, 25) }).dxScheduler("instance"); $("#deleteButton").dxButton({ text: "Delete", onClick: function () { scheduler.deleteAppointment(appointments[0]); } }); });
Angular
<dx-button text="Delete" (onClick)="deleteAppointment()"> </dx-button> <dx-scheduler [(dataSource)]="appointments" [currentDate]="currentDate"> </dx-scheduler>
import { Component, ViewChild } from "@angular/core"; import { Appointment, Service } from './app.service'; import { DxSchedulerComponent } from "devextreme-angular"; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'] }) export class AppComponent { @ViewChild(DxSchedulerComponent, { static: false }) scheduler: DxSchedulerComponent; // Prior to Angular 8 // @ViewChild(DxSchedulerComponent) scheduler: DxSchedulerComponent; currentDate: Date = new Date(2018, 4, 25); appointments: Appointment[]; constructor(service: Service) { this.appointments = service.getAppointments(); } deleteAppointment() { this.scheduler.instance.deleteAppointment(this.appointments[0]); } }
import { Injectable } from "@angular/core"; export class Appointment { text: string; startDate: Date; endDate: Date; recurrenceRule?: string; } let appointments: Appointment[] = [{ text: "Website Re-Design Plan", startDate: new Date(2018, 4, 25, 9, 0), endDate: new Date(2018, 4, 25, 9, 30), recurrenceRule: "FREQ=DAILY;COUNT=10" }, // ... ]; @Injectable() export class Service { getAppointments(): Appointment[] { return appointments; } }
import { BrowserModule } from '@angular/platform-browser'; import { NgModule } from '@angular/core'; import { AppComponent } from './app.component'; import { DxButtonModule, DxSchedulerModule } from "devextreme-angular"; import { Service } from './app.service'; @NgModule({ declarations: [ AppComponent ], imports: [ BrowserModule, DxButtonModule, DxSchedulerModule ], providers: [ Service ], bootstrap: [AppComponent] }) export class AppModule { }
Vue
<template> <div> <DxButton text="Delete" @click="deleteAppointment" /> <DxScheduler :ref="schedulerRef" :data-source="dataSource" :current-date="currentDate" /> </div> </template> <script> import 'devextreme/dist/css/dx.common.css'; import 'devextreme/dist/css/dx.light.css'; import DxScheduler from 'devextreme-vue/scheduler'; import DxButton from 'devextreme-vue/button'; import { appointments } from './data.js'; const schedulerRef = "scheduler"; export default { components: { DxScheduler, DxButton }, data() { return { schedulerRef, currentDate: new Date(2018, 4, 25), dataSource: appointments }; }, methods: { deleteAppointment() { this.scheduler.deleteAppointment(appointments[0]); } }, computed: { scheduler: function() { return this.$refs[schedulerRef].instance; } } }; </script>
export const appointments = [{ text: "Website Re-Design Plan", startDate: new Date(2018, 4, 25, 9, 0), endDate: new Date(2018, 4, 25, 9, 30), recurrenceRule: "FREQ=DAILY;COUNT=10" }, // ... ];
React
import React from 'react'; import 'devextreme/dist/css/dx.common.css'; import 'devextreme/dist/css/dx.light.css'; import Scheduler from 'devextreme-react/scheduler'; import Button from 'devextreme-react/button'; import { appointments } from './data.js'; const currentDate = new Date(2018, 4, 25); class App extends React.Component { constructor(props) { super(props); this.schedulerRef = React.createRef(); this.deleteAppointment = () => { this.scheduler.deleteAppointment(appointments[0]); } } get scheduler() { return this.schedulerRef.current.instance; } render() { return ( <div> <Button text="Delete" onClick={this.deleteAppointment} /> <Scheduler ref={this.schedulerRef} dataSource={appointments} defaultCurrentDate={currentDate} /> </div> ); } } export default App;
export const appointments = [{ text: "Website Re-Design Plan", startDate: new Date(2018, 4, 25, 9, 0), endDate: new Date(2018, 4, 25, 9, 30), recurrenceRule: "FREQ=DAILY;COUNT=10" }, // ... ];
See Also
- Call Methods: Angular | Vue | React | jQuery | AngularJS | Knockout
- onAppointmentDeleting
- onAppointmentDeleted
dispose()
After calling this method, remove the DOM element associated with the UI component:
$("#myScheduler").dxScheduler("dispose"); $("#myScheduler").remove();
Use this method only if the UI component was created with jQuery or pure JavaScript. In Angular, Vue, and React, use conditional rendering:
Angular
<dx-scheduler ... *ngIf="condition"> </dx-scheduler>
Vue
<template> <DxScheduler ... v-if="condition"> </DxScheduler> </template> <script> import DxScheduler from 'devextreme-vue/scheduler'; export default { components: { DxScheduler } } </script>
React
import React from 'react'; import Scheduler from 'devextreme-react/scheduler'; function DxScheduler(props) { if (!props.shouldRender) { return null; } return ( <Scheduler ... > </Scheduler> ); } class App extends React.Component { render() { return ( <DxScheduler shouldRender="condition" /> ); } } export default App;
See Also
getDataSource()
Gets the DataSource instance.
See Also
- Call Methods: Angular | Vue | React | jQuery | AngularJS | Knockout
- Data Layer - Overview
- Data Layer - DataSource Examples
getInstance(element)
getInstance is a static method that the UI component class supports. The following code demonstrates how to get the Scheduler instance found in an element with the myScheduler
ID:
// Modular approach import Scheduler from "devextreme/ui/scheduler"; ... let element = document.getElementById("myScheduler"); let instance = Scheduler.getInstance(element) as Scheduler; // Non-modular approach let element = document.getElementById("myScheduler"); let instance = DevExpress.ui.dxScheduler.getInstance(element);
See Also
scrollTo(date, group, allDay)
Scrolls the current view to a specified position. Available for all views except "agenda". You should specify the height property to use this method.
If appointments are grouped by resources, specifies a group ID (optional).
If true, scrolls the view to the all-day panel of the specified group. Applies only if the all-day panel is visible.
The following example shows how to use this method:
// Scroll to January 14, 2021 scrollTo(new Date(2021, 0, 14)); // Scroll to the second group at 5:30 p.m. on January 14, 2021 scrollTo(new Date(2021, 0, 14, 17, 30), {groupId: 2}) // Scroll to the all-day panel of the second group scrollTo(new Date(2021, 0, 14, 17, 30), {groupId: 2}, true);
See Also
- Call Methods: Angular | Vue | React | jQuery | AngularJS | Knockout
- Group Appointments by Resources
- currentView
- scrolling
- crossScrollingEnabled
scrollToTime(hours, minutes, date)
If the specified date is outside the current date range, the method scrolls the view to the specified time.
See Also
showAppointmentPopup(appointmentData, createNewAppointment, currentAppointmentData)
The appointment's data object.
The difference between this and appointmentData fields is explained in the onAppointmentClick description.
updateAppointment(target, appointment)
See Also
- Call Methods: Angular | Vue | React | jQuery | AngularJS | Knockout
- onAppointmentUpdating
- onAppointmentUpdated
If you have technical questions, please create a support ticket in the DevExpress Support Center.