devextreme
Version:
JavaScript/TypeScript Component Suite for Responsive Web Development
271 lines (270 loc) • 9.88 kB
JavaScript
/**
* DevExtreme (esm/__internal/scheduler/header/m_header.js)
* Version: 25.2.5
* Build date: Fri Feb 20 2026
*
* Copyright (c) 2012 - 2026 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import "../../../ui/drop_down_button";
import registerComponent from "../../../core/component_registrator";
import devices from "../../../core/devices";
import errors from "../../../core/errors";
import $ from "../../../core/renderer";
import {
getPathParts
} from "../../../core/utils/data";
import dateUtils from "../../../core/utils/date";
import {
extend
} from "../../../core/utils/extend";
import Toolbar from "../../../ui/toolbar";
import Widget from "../../core/widget/widget";
import SchedulerCalendar from "./m_calendar";
import {
getDateNavigator,
getTodayButtonOptions
} from "./m_date_navigator";
import {
getCaption,
getNextIntervalDate,
getStep,
nextWeek
} from "./m_utils";
import {
getDropDownViewSwitcher,
getTabViewSwitcher
} from "./m_view_switcher";
const CLASSES = {
component: "dx-scheduler-header",
invisible: "dx-state-invisible"
};
const ITEM_NAMES = {
today: "today",
dateNavigator: "dateNavigator",
viewSwitcher: "viewSwitcher"
};
export class SchedulerHeader extends Widget {
get captionText() {
return this._getCaption().text
}
getIntervalOptions(date) {
const {
currentView: currentView,
firstDayOfWeek: firstDayOfWeek
} = this.option();
const step = getStep(currentView.type);
return {
date: date,
step: step,
firstDayOfWeek: firstDayOfWeek,
intervalCount: currentView.intervalCount,
agendaDuration: currentView.agendaDuration
}
}
_getDefaultOptions() {
return extend(super._getDefaultOptions(), {
_useShortDateFormat: !devices.real().generic || devices.isSimulator()
})
}
_createEventMap() {
this.eventMap = new Map([
["currentView", []],
["views", []],
["currentDate", [this._getCalendarOptionUpdater("value")]],
["min", [this._getCalendarOptionUpdater("min")]],
["max", [this._getCalendarOptionUpdater("max")]],
["tabIndex", [this.repaint.bind(this)]],
["focusStateEnabled", [this.repaint.bind(this)]],
["useDropDownViewSwitcher", [this.repaint.bind(this)]],
["indicatorTime", []]
])
}
_addEvent(name, event) {
const events = this.eventMap.get(name) ?? [];
this.eventMap.set(name, [...events, event])
}
_optionChanged(args) {
const {
name: name,
value: value
} = args;
const events = this.eventMap.get(name);
null === events || void 0 === events || events.forEach((event => {
event(value)
}))
}
onToolbarOptionChanged(fullName, value) {
var _this$_toolbar, _this$_toolbar2, _this$_toolbar3;
const parts = getPathParts(fullName);
const optionName = fullName.replace(/^toolbar\./, "");
this.option(fullName, value);
this._toggleVisibility();
switch (true) {
case "toolbar" === fullName:
this.repaint();
break;
case "toolbar.items" === fullName:
null === (_this$_toolbar = this._toolbar) || void 0 === _this$_toolbar || _this$_toolbar.option("items", value.map((item => this._parseItem(item))));
break;
case "items" === parts[1] && 3 === parts.length:
null === (_this$_toolbar2 = this._toolbar) || void 0 === _this$_toolbar2 || _this$_toolbar2.option(optionName, this._parseItem(value));
break;
default:
null === (_this$_toolbar3 = this._toolbar) || void 0 === _this$_toolbar3 || _this$_toolbar3.option(optionName, value)
}
}
_init() {
super._init();
this._createEventMap();
this.$element().addClass(CLASSES.component)
}
_render() {
super._render();
this._createEventMap();
this._renderToolbar();
this._toggleVisibility()
}
_renderToolbar() {
const config = this._createToolbarConfig();
const toolbarElement = $("<div>");
toolbarElement.appendTo(this.$element());
this._toolbar = this._createComponent(toolbarElement, Toolbar, config)
}
_toggleVisibility() {
const {
toolbar: toolbar
} = this.option();
const isHeaderShown = toolbar.visible ?? toolbar.items.length;
if (isHeaderShown) {
this.$element().removeClass(CLASSES.invisible)
} else {
this.$element().addClass(CLASSES.invisible)
}
}
_createToolbarConfig() {
const {
toolbar: toolbar
} = this.option();
const parsedItems = toolbar.items.map((element => this._parseItem(element)));
return Object.assign({}, toolbar, {
items: parsedItems
})
}
_parseItem(item) {
const itemName = "string" === typeof item ? item : item.name;
const itemOptions = "string" === typeof item ? {} : item;
if (itemName) {
switch (itemName) {
case ITEM_NAMES.today:
return getTodayButtonOptions(this, itemOptions);
case ITEM_NAMES.viewSwitcher:
return this.option().useDropDownViewSwitcher ? getDropDownViewSwitcher(this, itemOptions) : getTabViewSwitcher(this, itemOptions);
case ITEM_NAMES.dateNavigator:
this._renderCalendar();
return getDateNavigator(this, itemOptions);
default:
errors.log(`Unknown default element type: ${itemName}`)
}
}
return extend(true, {}, item)
}
_callEvent(event, arg) {
const events = this.eventMap.get(event);
null === events || void 0 === events || events.forEach((EventMapHandler => EventMapHandler(arg)))
}
_updateCurrentView(view) {
const {
onCurrentViewChange: onCurrentViewChange
} = this.option();
onCurrentViewChange(view.name)
}
_updateCalendarValueAndCurrentDate(date) {
var _this$_calendar;
this._updateCurrentDate(date);
null === (_this$_calendar = this._calendar) || void 0 === _this$_calendar || _this$_calendar.option("value", date)
}
_updateCurrentDate(date) {
const {
onCurrentDateChange: onCurrentDateChange
} = this.option();
onCurrentDateChange(date);
this._callEvent("currentDate", date)
}
_renderCalendar() {
const {
currentDate: currentDate,
min: min,
max: max,
firstDayOfWeek: firstDayOfWeek,
focusStateEnabled: focusStateEnabled,
tabIndex: tabIndex
} = this.option();
this._calendar = this._createComponent("<div>", SchedulerCalendar, {
value: currentDate,
min: min,
max: max,
firstDayOfWeek: firstDayOfWeek,
focusStateEnabled: focusStateEnabled,
tabIndex: tabIndex,
onValueChanged: async e => {
var _this$_calendar2;
this._updateCurrentDate(e.value);
await (null === (_this$_calendar2 = this._calendar) || void 0 === _this$_calendar2 ? void 0 : _this$_calendar2.hide())
}
});
this._calendar.$element().appendTo(this.$element())
}
_getCalendarOptionUpdater(name) {
return value => {
if (this._calendar) {
this._calendar.option(name, value)
}
}
}
_getNextDate(direction, initialDate) {
const {
currentDate: currentDate
} = this.option();
const date = initialDate ?? currentDate;
const options = this.getIntervalOptions(date);
return getNextIntervalDate(options, direction)
}
_getDisplayedDate() {
const {
startViewDate: startViewDate,
currentView: currentView
} = this.option();
const isMonth = "month" === currentView.type;
return isMonth ? nextWeek(startViewDate) : startViewDate
}
_getCaptionOptions() {
const {
currentDate: currentDate,
startViewDate: startViewDate
} = this.option();
let date = currentDate;
if (startViewDate) {
date = this._getDisplayedDate()
}
date = dateUtils.trimTime(date);
return this.getIntervalOptions(date)
}
_getCaption() {
const {
customizeDateNavigatorText: customizeDateNavigatorText
} = this.option();
const options = this._getCaptionOptions();
const useShortDateFormat = this.option()._useShortDateFormat;
return getCaption(options, Boolean(useShortDateFormat), customizeDateNavigatorText)
}
_updateDateByDirection(direction) {
const date = this._getNextDate(direction);
this._updateCalendarValueAndCurrentDate(date)
}
async _showCalendar(e) {
var _this$_calendar3;
await (null === (_this$_calendar3 = this._calendar) || void 0 === _this$_calendar3 ? void 0 : _this$_calendar3.show(e.element))
}
}
registerComponent("dxSchedulerHeader", SchedulerHeader);