devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
719 lines (718 loc) • 29.3 kB
JavaScript
/**
* DevExtreme (esm/__internal/scheduler/m_recurrence_editor.js)
* Version: 25.1.3
* Build date: Wed Jun 25 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import "../../ui/radio_group";
import dateLocalization from "../../common/core/localization/date";
import messageLocalization from "../../common/core/localization/message";
import registerComponent from "../../core/component_registrator";
import $ from "../../core/renderer";
import dateUtils from "../../core/utils/date";
import {
extend
} from "../../core/utils/extend";
import {
isDefined
} from "../../core/utils/type";
import ButtonGroup from "../../ui/button_group";
import Editor from "../../ui/editor/editor";
import Form from "../../ui/form";
import {
current,
isFluent
} from "../../ui/themes";
import {
getRecurrenceProcessor
} from "./m_recurrence";
const RECURRENCE_EDITOR = "dx-recurrence-editor";
const LABEL_POSTFIX = "-label";
const WRAPPER_POSTFIX = "-wrapper";
const RECURRENCE_EDITOR_CONTAINER = "dx-recurrence-editor-container";
const REPEAT_END_TYPE_EDITOR = "dx-recurrence-radiogroup-repeat-type";
const REPEAT_COUNT_EDITOR = "dx-recurrence-numberbox-repeat-count";
const REPEAT_UNTIL_DATE_EDITOR = "dx-recurrence-datebox-until-date";
const RECURRENCE_BUTTON_GROUP = "dx-recurrence-button-group";
const FREQUENCY_EDITOR = "dx-recurrence-selectbox-freq";
const INTERVAL_EDITOR = "dx-recurrence-numberbox-interval";
const REPEAT_ON_EDITOR = "dx-recurrence-repeat-on";
const DAY_OF_MONTH = "dx-recurrence-numberbox-day-of-month";
const MONTH_OF_YEAR = "dx-recurrence-selectbox-month-of-year";
const recurrentEditorNumberBoxWidth = 90;
const repeatInputWidth = "100%";
const recurrentEditorSelectBoxWidth = 120;
const defaultRecurrenceTypeIndex = 1;
const frequenciesMessages = [{
recurrence: "dxScheduler-recurrenceHourly",
value: "hourly"
}, {
recurrence: "dxScheduler-recurrenceDaily",
value: "daily"
}, {
recurrence: "dxScheduler-recurrenceWeekly",
value: "weekly"
}, {
recurrence: "dxScheduler-recurrenceMonthly",
value: "monthly"
}, {
recurrence: "dxScheduler-recurrenceYearly",
value: "yearly"
}];
const frequencies = frequenciesMessages.map((item => ({
text: () => messageLocalization.format(item.recurrence),
value: item.value
})));
const repeatEndTypes = [{
type: "never"
}, {
type: "until"
}, {
type: "count"
}];
const days = ["SU", "MO", "TU", "WE", "TH", "FR", "SA"];
const getStylingModeFunc = () => isFluent(current()) ? "filled" : void 0;
class RecurrenceRule {
constructor(rule) {
this._recurrenceProcessor = getRecurrenceProcessor();
this._recurrenceProcessor = getRecurrenceProcessor();
this._recurrenceRule = this._recurrenceProcessor.evalRecurrenceRule(rule).rule
}
makeRules(string) {
this._recurrenceRule = this._recurrenceProcessor.evalRecurrenceRule(string).rule
}
makeRule(field, value) {
if (!value || Array.isArray(value) && !value.length) {
delete this._recurrenceRule[field];
return
}
if (isDefined(field)) {
if ("until" === field) {
delete this._recurrenceRule.count
}
if ("count" === field) {
delete this._recurrenceRule.until
}
this._recurrenceRule[field] = value
}
}
getRepeatEndRule() {
const rules = this._recurrenceRule;
if ("count" in rules) {
return "count"
}
if ("until" in rules) {
return "until"
}
return "never"
}
getRecurrenceString() {
return this._recurrenceProcessor.getRecurrenceString(this._recurrenceRule)
}
getRules() {
return this._recurrenceRule
}
getDaysFromByDayRule() {
return this._recurrenceProcessor.daysFromByDayRule(this._recurrenceRule)
}
}
class RecurrenceEditor extends Editor {
_getDefaultOptions() {
const defaultOptions = super._getDefaultOptions();
return extend(defaultOptions, {
value: null,
startDate: new Date,
firstDayOfWeek: void 0
})
}
_getFirstDayOfWeek() {
const firstDayOfWeek = this.option("firstDayOfWeek");
return isDefined(firstDayOfWeek) ? firstDayOfWeek : dateLocalization.firstDayOfWeekIndex()
}
_createComponent(element, name) {
let config = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : {};
this._extendConfig(config, {
readOnly: this.option("readOnly")
});
return super._createComponent(element, name, config)
}
_init() {
super._init();
this._recurrenceRule = new RecurrenceRule(this.option("value"))
}
_render() {
super._render();
this.$element().addClass(RECURRENCE_EDITOR);
this._$container = $("<div>").addClass(RECURRENCE_EDITOR_CONTAINER).appendTo(this.$element());
this._prepareEditors();
this._renderEditors(this._$container);
this._updateRepeatInputAriaLabel()
}
getEditorByField(fieldName) {
let editor = this.getRecurrenceForm().getEditor(fieldName);
if (!isDefined(editor)) {
if ("byday" === fieldName) {
editor = this._weekEditor
}
}
return editor
}
_prepareEditors() {
const freq = (this._recurrenceRule.getRules().freq || frequenciesMessages[1].value).toLowerCase();
this._editors = [this._createFreqEditor(freq), this._createIntervalEditor(freq), this._createRepeatOnLabel(freq), {
itemType: "group",
cssClass: REPEAT_ON_EDITOR,
colCount: 2,
colCountByScreen: {
xs: 2
},
items: this._createRepeatOnEditor(freq)
}, {
itemType: "group",
colCount: 2,
items: this._createRepeatEndEditor()
}];
return this._editors
}
_createFreqEditor(freq) {
return {
dataField: "freq",
name: "FREQ",
editorType: "dxSelectBox",
cssClass: FREQUENCY_EDITOR,
editorOptions: {
stylingMode: getStylingModeFunc(),
items: frequencies,
value: freq,
field: "freq",
valueExpr: "value",
displayExpr: "text",
layout: "horizontal",
elementAttr: {
class: FREQUENCY_EDITOR
},
onValueChanged: args => this._valueChangedHandler(args)
},
label: {
text: messageLocalization.format("dxScheduler-editorLabelRecurrence")
}
}
}
_createIntervalEditor(freq) {
const interval = this._recurrenceRule.getRules().interval || 1;
return {
itemType: "group",
colCount: 2,
cssClass: `${INTERVAL_EDITOR}-wrapper`,
colCountByScreen: {
xs: 2
},
items: [{
dataField: "interval",
editorType: "dxNumberBox",
editorOptions: {
stylingMode: getStylingModeFunc(),
format: "#",
width: 90,
min: 1,
field: "interval",
value: interval,
showSpinButtons: true,
useLargeSpinButtons: false,
elementAttr: {
class: INTERVAL_EDITOR
},
onValueChanged: args => this._valueChangedHandler(args)
},
label: {
text: messageLocalization.format("dxScheduler-recurrenceRepeatEvery")
}
}, {
name: "intervalLabel",
cssClass: `${INTERVAL_EDITOR}-label`,
template: () => messageLocalization.format(`dxScheduler-recurrenceRepeat${freq.charAt(0).toUpperCase()}${freq.substr(1).toLowerCase()}`)
}]
}
}
_createRepeatOnLabel(freq) {
return {
itemType: "group",
cssClass: `${REPEAT_ON_EDITOR}-label`,
items: [{
name: "repeatOnLabel",
colSpan: 2,
template: () => messageLocalization.format("dxScheduler-recurrenceRepeatOn"),
visible: freq && "daily" !== freq && "hourly" !== freq
}]
}
}
_createRepeatOnEditor(freq) {
return [this._createByDayEditor(freq), this._createByMonthEditor(freq), this._createByMonthDayEditor(freq)]
}
_createByDayEditor(freq) {
return {
dataField: "byday",
colSpan: 2,
template: (_, itemElement) => {
const firstDayOfWeek = this._getFirstDayOfWeek();
const byDay = this._daysOfWeekByRules();
const localDaysNames = dateLocalization.getDayNames("abbreviated");
const dayNames = days.slice(firstDayOfWeek).concat(days.slice(0, firstDayOfWeek));
const itemsButtonGroup = localDaysNames.slice(firstDayOfWeek).concat(localDaysNames.slice(0, firstDayOfWeek)).map(((item, index) => ({
text: item,
key: dayNames[index]
})));
this._$repeatOnWeek = $("<div>").addClass(RECURRENCE_BUTTON_GROUP).appendTo(itemElement);
this._weekEditor = this._createComponent(this._$repeatOnWeek, ButtonGroup, {
items: itemsButtonGroup,
field: "byday",
selectionMode: "multiple",
selectedItemKeys: byDay,
keyExpr: "key",
onSelectionChanged: e => {
const selectedItemKeys = e.component.option("selectedItemKeys");
const selectedKeys = null !== selectedItemKeys && void 0 !== selectedItemKeys && selectedItemKeys.length ? selectedItemKeys : this._getDefaultByDayValue();
this._recurrenceRule.makeRule("byday", selectedKeys);
this._changeEditorValue()
}
})
},
visible: "weekly" === freq,
label: {
visible: false
}
}
}
_createByMonthEditor(freq) {
const monthsName = dateLocalization.getMonthNames("wide");
const months = [...Array(12)].map(((_, i) => ({
value: `${i+1}`,
text: monthsName[i]
})));
return {
dataField: "bymonth",
editorType: "dxSelectBox",
editorOptions: {
stylingMode: getStylingModeFunc(),
field: "bymonth",
items: months,
value: this._monthOfYearByRules(),
width: 120,
displayExpr: "text",
valueExpr: "value",
elementAttr: {
class: MONTH_OF_YEAR
},
onValueChanged: args => this._valueChangedHandler(args)
},
visible: "yearly" === freq,
label: {
visible: false
}
}
}
_createByMonthDayEditor(freq) {
return {
dataField: "bymonthday",
editorType: "dxNumberBox",
editorOptions: {
stylingMode: getStylingModeFunc(),
min: 1,
max: 31,
format: "#",
width: 90,
field: "bymonthday",
showSpinButtons: true,
useLargeSpinButtons: false,
value: this._dayOfMonthByRules(),
elementAttr: {
class: DAY_OF_MONTH
},
onValueChanged: args => this._valueChangedHandler(args)
},
visible: "monthly" === freq || "yearly" === freq,
label: {
visible: false
}
}
}
_createRepeatEndEditor() {
const repeatType = this._recurrenceRule.getRepeatEndRule();
return [{
colSpan: 2,
template: messageLocalization.format("dxScheduler-recurrenceEnd")
}, {
colSpan: 1,
label: {
visible: false
},
dataField: "repeatEnd",
editorType: "dxRadioGroup",
editorOptions: {
items: repeatEndTypes,
value: repeatType,
valueExpr: "type",
field: "repeatEnd",
itemTemplate: itemData => {
if ("count" === itemData.type) {
return messageLocalization.format("dxScheduler-recurrenceAfter")
}
if ("until" === itemData.type) {
return messageLocalization.format("dxScheduler-recurrenceOn")
}
return messageLocalization.format("dxScheduler-recurrenceNever")
},
layout: "vertical",
elementAttr: {
class: REPEAT_END_TYPE_EDITOR
},
onValueChanged: args => this._repeatEndValueChangedHandler(args)
}
}, {
colSpan: 1,
itemType: "group",
items: [this._getRepeatUntilEditorOptions(), this._getRepeatCountEditorOptions()]
}]
}
_renderEditors($container) {
this._recurrenceForm = this._createComponent($container, Form, {
items: this._editors,
showValidationSummary: false,
scrollingEnabled: true,
showColonAfterLabel: false,
labelLocation: "top"
});
this._changeRepeatEndInputsVisibility()
}
getRecurrenceForm() {
return this._recurrenceForm
}
changeValueByVisibility(value) {
if (value) {
if (!this.option("value")) {
this._handleDefaults()
}
} else {
this._recurrenceRule.makeRules("");
this.option("value", "")
}
}
_handleDefaults() {
this._recurrenceRule.makeRule("freq", frequenciesMessages[1].value);
this._changeEditorValue()
}
_changeEditorValue() {
this.option("value", this._recurrenceRule.getRecurrenceString() || "")
}
_daysOfWeekByRules() {
let daysByRule = this._recurrenceRule.getDaysFromByDayRule();
if (!daysByRule.length) {
daysByRule = this._getDefaultByDayValue()
}
return daysByRule
}
_getDefaultByDayValue() {
const startDate = this.option("startDate");
const startDay = startDate.getDay();
return [days[startDay]]
}
_dayOfMonthByRules() {
let dayByRule = this._recurrenceRule.getRules().bymonthday;
if (!dayByRule) {
dayByRule = this.option("startDate").getDate()
}
return dayByRule
}
_monthOfYearByRules() {
let monthByRule = this._recurrenceRule.getRules().bymonth;
if (!monthByRule) {
monthByRule = this.option("startDate").getMonth() + 1
}
return String(monthByRule)
}
_repeatEndValueChangedHandler(args) {
const {
value: value
} = args;
this._changeRepeatEndInputsVisibility(value);
if ("until" === value) {
this._recurrenceRule.makeRule(value, this._getUntilValue())
}
if ("count" === value) {
this._recurrenceRule.makeRule(value, this._recurrenceForm.option("formData.count"))
}
if ("never" === value) {
this._recurrenceRule.makeRule("count", "");
this._recurrenceRule.makeRule("until", "")
}
this._changeEditorValue();
this._updateRepeatInputAriaLabel()
}
_changeRepeatEndInputsVisibility() {
let value = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : this._recurrenceRule.getRepeatEndRule();
if ("until" === value) {
this._recurrenceForm.itemOption("until", "visible", true);
this._recurrenceForm.itemOption("count", "visible", false)
}
if ("count" === value) {
this._recurrenceForm.itemOption("until", "visible", false);
this._recurrenceForm.itemOption("count", "visible", true)
}
if ("never" === value) {
this._recurrenceForm.itemOption("until", "visible", false);
this._recurrenceForm.itemOption("count", "visible", false)
}
}
_getRepeatCountEditorOptions() {
const count = this._recurrenceRule.getRules().count || 1;
return {
dataField: "count",
cssClass: REPEAT_COUNT_EDITOR,
label: {
visible: false
},
editorType: "dxNumberBox",
editorOptions: {
stylingMode: getStylingModeFunc(),
field: "count",
format: `# ${messageLocalization.format("dxScheduler-recurrenceRepeatCount")}`,
width: "100%",
min: 1,
showSpinButtons: true,
useLargeSpinButtons: false,
value: count,
onValueChanged: this._repeatCountValueChangeHandler.bind(this),
inputAttr: {
"aria-label": messageLocalization.format("dxScheduler-recurrenceOccurrenceLabel")
}
}
}
}
_updateRepeatInputAriaLabel() {
const radioButtons = this.getEditorByField("repeatEnd").itemElements();
const untilLabel = messageLocalization.format("dxScheduler-recurrenceOn");
const untilValue = this._recurrenceForm.getEditor("until").option("value");
const untilValueFormat = `${dateLocalization.format(untilValue,"d")} ${dateLocalization.format(untilValue,"monthAndYear")}`;
const isUntilVisible = this._recurrenceForm.itemOption("until").visible;
const countLabel = messageLocalization.format("dxScheduler-recurrenceAfter");
const countPostfix = messageLocalization.format("dxScheduler-recurrenceRepeatCount");
const countValue = this._recurrenceForm.getEditor("count").option("value");
const isCountVisible = this._recurrenceForm.itemOption("count").visible;
radioButtons[1].setAttribute("aria-label", isUntilVisible ? `${untilLabel} ${untilValueFormat}` : untilLabel);
radioButtons[2].setAttribute("aria-label", isCountVisible ? `${countLabel} ${countValue} ${countPostfix}` : countLabel)
}
_repeatCountValueChangeHandler(args) {
if ("count" === this._recurrenceRule.getRepeatEndRule()) {
const {
value: value
} = args;
this._recurrenceRule.makeRule("count", value);
this._changeEditorValue();
this._updateRepeatInputAriaLabel()
}
}
_getRepeatUntilEditorOptions() {
const until = this._getUntilValue();
return {
dataField: "until",
label: {
visible: false
},
cssClass: REPEAT_UNTIL_DATE_EDITOR,
editorType: "dxDateBox",
editorOptions: {
stylingMode: getStylingModeFunc(),
field: "until",
value: until,
type: "date",
width: "100%",
onValueChanged: this._repeatUntilValueChangeHandler.bind(this),
calendarOptions: {
firstDayOfWeek: this._getFirstDayOfWeek()
},
useMaskBehavior: true,
inputAttr: {
"aria-label": messageLocalization.format("dxScheduler-recurrenceUntilDateLabel")
}
}
}
}
_formatUntilDate(date) {
const untilDate = this._recurrenceRule.getRules().until;
const isSameDate = dateUtils.sameDate(untilDate, date);
return untilDate && isSameDate ? date : dateUtils.setToDayEnd(date)
}
_repeatUntilValueChangeHandler(args) {
if ("until" === this._recurrenceRule.getRepeatEndRule()) {
const dateInTimeZone = this._formatUntilDate(new Date(args.value));
const getStartDateTimeZone = this.option("getStartDateTimeZone");
const appointmentTimeZone = getStartDateTimeZone();
const path = appointmentTimeZone ? "fromAppointment" : "fromGrid";
const dateInLocaleTimeZone = this.option("timeZoneCalculator").createDate(dateInTimeZone, path, appointmentTimeZone);
this._recurrenceRule.makeRule("until", dateInLocaleTimeZone);
this._changeEditorValue();
this._updateRepeatInputAriaLabel()
}
}
_valueChangedHandler(args) {
const {
value: value,
previousValue: previousValue
} = args;
const field = args.component.option("field");
if (!this.option("visible")) {
this.option("value", "")
} else {
this._recurrenceRule.makeRule(field, value);
if ("freq" === field) {
this._makeRepeatOnRule(value);
this._changeRepeatOnVisibility(value, previousValue)
}
this._changeEditorValue()
}
}
_makeRepeatOnRule(value) {
if ("daily" === value || "hourly" === value) {
this._recurrenceRule.makeRule("byday", "");
this._recurrenceRule.makeRule("bymonth", "");
this._recurrenceRule.makeRule("bymonthday", "")
}
if ("weekly" === value) {
this._recurrenceRule.makeRule("byday", this._daysOfWeekByRules());
this._recurrenceRule.makeRule("bymonth", "");
this._recurrenceRule.makeRule("bymonthday", "")
}
if ("monthly" === value) {
this._recurrenceRule.makeRule("bymonthday", this._dayOfMonthByRules());
this._recurrenceRule.makeRule("bymonth", "");
this._recurrenceRule.makeRule("byday", "")
}
if ("yearly" === value) {
this._recurrenceRule.makeRule("bymonthday", this._dayOfMonthByRules());
this._recurrenceRule.makeRule("bymonth", this._monthOfYearByRules());
this._recurrenceRule.makeRule("byday", "")
}
}
_optionChanged(args) {
var _this$_recurrenceForm, _this$_weekEditor;
switch (args.name) {
case "readOnly":
null === (_this$_recurrenceForm = this._recurrenceForm) || void 0 === _this$_recurrenceForm || _this$_recurrenceForm.option("readOnly", args.value);
null === (_this$_weekEditor = this._weekEditor) || void 0 === _this$_weekEditor || _this$_weekEditor.option("readOnly", args.value);
super._optionChanged(args);
break;
case "value":
this._recurrenceRule.makeRules(args.value);
this._changeRepeatIntervalLabel();
this._changeRepeatEndInputsVisibility();
this._changeEditorsValue(this._recurrenceRule.getRules());
super._optionChanged(args);
break;
case "startDate":
this._makeRepeatOnRule(this._recurrenceRule.getRules().freq);
if (isDefined(this._recurrenceRule.getRecurrenceString())) {
this._changeEditorValue()
}
break;
case "firstDayOfWeek":
if (this._weekEditor) {
const localDaysNames = dateLocalization.getDayNames("abbreviated");
const dayNames = days.slice(args.value).concat(days.slice(0, args.value));
const itemsButtonGroup = localDaysNames.slice(args.value).concat(localDaysNames.slice(0, args.value)).map(((item, index) => ({
text: item,
key: dayNames[index]
})));
this._weekEditor.option("items", itemsButtonGroup)
}
if (this._recurrenceForm.itemOption("until").visible) {
this._recurrenceForm.getEditor("until").option("calendarOptions.firstDayOfWeek", this._getFirstDayOfWeek())
}
break;
default:
super._optionChanged(args)
}
}
_changeRepeatOnVisibility(freq, previousFreq) {
if (freq !== previousFreq) {
this._recurrenceForm.itemOption("byday", "visible", false);
this._recurrenceForm.itemOption("bymonthday", "visible", false);
this._recurrenceForm.itemOption("bymonth", "visible", false);
this._recurrenceForm.itemOption("repeatOnLabel", "visible", freq && "daily" !== freq && "hourly" !== freq);
if ("weekly" === freq) {
this._recurrenceForm.itemOption("byday", "visible", true)
}
if ("monthly" === freq) {
this._recurrenceForm.itemOption("bymonthday", "visible", true)
}
if ("yearly" === freq) {
this._recurrenceForm.itemOption("bymonthday", "visible", true);
this._recurrenceForm.itemOption("bymonth", "visible", true)
}
}
}
_changeRepeatIntervalLabel() {
const {
freq: freq
} = this._recurrenceRule.getRules();
freq && this._recurrenceForm.itemOption("intervalLabel", "template", messageLocalization.format(`dxScheduler-recurrenceRepeat${freq.charAt(0).toUpperCase()}${freq.substr(1).toLowerCase()}`))
}
_changeEditorsValue(rules) {
this._recurrenceForm.getEditor("freq").option("value", (rules.freq || frequenciesMessages[1].value).toLowerCase());
this._changeDayOfWeekValue();
this._changeDayOfMonthValue();
this._changeMonthOfYearValue();
this._changeIntervalValue(rules.interval);
this._changeRepeatCountValue();
this._changeRepeatEndValue();
this._changeRepeatUntilValue()
}
_changeIntervalValue(value) {
this._recurrenceForm.getEditor("interval").option("value", value || 1)
}
_changeRepeatEndValue() {
const repeatType = this._recurrenceRule.getRepeatEndRule();
this._recurrenceForm.getEditor("repeatEnd").option("value", repeatType)
}
_changeDayOfWeekValue() {
const isEditorVisible = this._recurrenceForm.itemOption("byday").visible;
if (isEditorVisible) {
const days = this._daysOfWeekByRules();
this.getEditorByField("byday").option("selectedItemKeys", days)
}
}
_changeDayOfMonthValue() {
const isEditorVisible = this._recurrenceForm.itemOption("bymonthday").visible;
if (isEditorVisible) {
const day = this._dayOfMonthByRules();
this._recurrenceForm.getEditor("bymonthday").option("value", day)
}
}
_changeMonthOfYearValue() {
const isEditorVisible = this._recurrenceForm.itemOption("bymonth").visible;
if (isEditorVisible) {
const month = this._monthOfYearByRules();
this._recurrenceForm.getEditor("bymonth").option("value", month)
}
}
_changeRepeatCountValue() {
const count = this._recurrenceRule.getRules().count || 1;
this._recurrenceForm.getEditor("count").option("value", count)
}
_changeRepeatUntilValue() {
this._recurrenceForm.getEditor("until").option("value", this._getUntilValue())
}
_getUntilValue() {
const untilDate = this._recurrenceRule.getRules().until;
if (!untilDate) {
return this._formatUntilDate(new Date)
}
const getStartDateTimeZone = this.option("getStartDateTimeZone");
const appointmentTimeZone = getStartDateTimeZone();
const path = appointmentTimeZone ? "toAppointment" : "toGrid";
return this.option("timeZoneCalculator").createDate(untilDate, path, appointmentTimeZone)
}
}
registerComponent("dxRecurrenceEditor", RecurrenceEditor);
export default RecurrenceEditor;