From a05882e0771b56d88f97f77dd2b1c5795a1ebeca Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 17 Nov 2025 09:41:30 +0400 Subject: [PATCH 1/9] Scheduler: Add New Appointment Edit Form API desc. --- .../1 Configuration/editing/form/form.md | 4 +- .../editing/form/iconsShowMode.md | 13 +++++- .../1 Configuration/editing/form/items.md | 44 ++++++++++++++++++- .../editing/form/onCanceled.md | 4 +- .../1 Configuration/editing/form/onSaved.md | 4 +- .../1 Configuration/editing/popup.md | 4 +- .../9 Types/AppointmentFormIconsShowMode.md | 13 +++++- 7 files changed, 72 insertions(+), 14 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md index 9262f0c4b0..841d7e42c2 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md @@ -5,7 +5,7 @@ default: undefined --- --- ##### shortDescription - +Configures the [Form](/Documentation/Guide/UI_Components/Form/Overview/) component within the Scheduler appointment edit form. --- - \ No newline at end of file +In addition to **editing**.**form** properties, you can specify DevExtreme [Form](/Documentation/Guide/UI_Components/Form/Overview/) configuration options to customize the appointment edit form. \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md index 5ee0f1ea05..ab83ce62c4 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md @@ -5,7 +5,16 @@ default: 'main' --- --- ##### shortDescription - +Configures icon visibility within the Appointment Edit Form. --- - \ No newline at end of file +The Scheduler Appointment Edit Form consists of two parts: a general information form and a recurrence settings form. Implement [AppointmentFormIconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Types/#AppointmentFormIconsShowMode) values to configure icon visibility as follows: + +- *"both"* +Icons are visible in both general information and recurrence settings forms. +- *"main"* +Icons are visible in the general information form only. +- *"recurrence"* +Icons are visible in the recurrence settings form only. +- *"none"* +Icons are hidden in both forms. diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md index 76791749f0..741a3072c8 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md @@ -5,7 +5,47 @@ default: [] --- --- ##### shortDescription - +Configures Appointment Edit Form items. --- - \ No newline at end of file +The following predefined items are available in the Appointment Edit Form: + + editing.form.items + ├─ mainGroup + | ├─ subjectGroup + | │ ├─ subjectIcon + | │ └─ subjectEditor + | └─ dateGroup + | ├─ dateIcon + | ├─ allDayEditor + | ├─ startDateGroup + | │ ├─ startDateTimeGroup + | │ │ ├─ startDateEditor + | │ │ └─ startTimeEditor + | │ └─ startDateTimezoneEditor + | ├─ endDateGroup + | │ ├─ endDateTimeGroup + | │ │ ├─ endDateEditor + | │ │ └─ endTimeEditor + | │ └─ endDateTimezoneEditor + | ├─ repeatGroup + | │ ├─ repeatIcon + | │ └─ repeatEditor + | └─ descriptionGroup + | ├─ descriptionIcon + | └─ descriptionEditor + └─ recurrenceGroup + ├─ recurrenceStartDateGroup + │ ├─ recurrenceStartDateIcon + │ └─ recurrenceStartDateEditor + ├─ recurrenceRuleGroup + │ ├─ recurrenceRuleIcon + │ ├─ recurrenceRuleRepeatGroup + │ ├─ recurrenceCountEditor + │ ├─ recurrencePeriodEditor + │ └─ recurrenceDayOfYearGroup — recurrenceDaysOfWeekEditor — recurrenceDayOfMonthEditor + │ ├─ recurrenceDayOfYearMonthEditor + │ └─ recurrenceDayOfYearDayEditor + └─ recurrenceEndGroup + ├─ recurrenceEndIcon + └─ recurrenceEndEditor diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onCanceled.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onCanceled.md index cde5bbf4db..044440d674 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onCanceled.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onCanceled.md @@ -5,10 +5,10 @@ default: undefined --- --- ##### shortDescription - +A function that is executed when users cancel their changes in the appointment edit form. ##### param(formData): Object - +Details of the modified appointment. --- \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onSaved.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onSaved.md index f4a321e8a4..d959d11884 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onSaved.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/onSaved.md @@ -5,10 +5,10 @@ default: undefined --- --- ##### shortDescription - +A function that is executed when users confirm their changes in the appointment edit form. ##### param(formData): Object - +Details of the modified appointment. --- \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/popup.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/popup.md index 2e2fb69ac0..ec6bfa2bc9 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/popup.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/popup.md @@ -4,7 +4,7 @@ type: dxPopup_Options --- --- ##### shortDescription - +Configures the [Popup](/Documentation/Guide/UI_Components/Popup/Overview/) component that contains the Scheduler appointment edit form. --- - \ No newline at end of file +Specify DevExtreme [Popup](/Documentation/Guide/UI_Components/Popup/Overview/) configuration options to customize the appointment edit form. \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md b/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md index 8ca592a6cb..6dd7ae0063 100644 --- a/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md +++ b/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md @@ -6,7 +6,16 @@ references: dxScheduler.Options.editing.form.iconsShowMode --- --- ##### shortDescription - +Specifies icon visibility within the Appointment Edit Form. --- - \ No newline at end of file +The Scheduler Appointment Edit Form consists of two parts: a general information form and a recurrence settings form. Implement **AppointmentFormIconsShowMode** values in **editing**.**form**.[iconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#iconsShowMode) to configure icon visibility as follows: + +- *"both"* +Display icons in both general information and recurrence settings forms. +- *"main"* +Display icons in the general information form only. +- *"recurrence"* +Display icons in the recurrence settings form only. +- *"none"* +Hide icons in both forms. From 8c38e4ea5b42b6a35164fc8b472e0a0068c65d50 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 17 Nov 2025 14:12:52 +0400 Subject: [PATCH 2/9] Add final touches --- .../dxScheduler/1 Configuration/editing/editing.md | 2 +- .../dxScheduler/1 Configuration/resources/icon.md | 4 ++-- .../dxScheduler/1 Configuration/resources/label.md | 10 +++++++++- 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/editing.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/editing.md index 9ba54bfd88..62095b105c 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/editing.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/editing.md @@ -5,7 +5,7 @@ default: true --- --- ##### shortDescription -Specifies which editing operations a user can perform on appointments. +Configures appointment editing options, such as available operations. --- diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/icon.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/icon.md index 6028edc369..1044c765b3 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/icon.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/icon.md @@ -5,7 +5,7 @@ default: '' --- --- ##### shortDescription - +Specifies a resource [icon](/Documentation/Guide/Themes_and_Styles/Icons/#Built-In_Icon_Library). --- - \ No newline at end of file +Scheduler displays resource icons in the appointment edit form. \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md index 6703d747aa..ac9acf83b8 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md @@ -5,9 +5,17 @@ default: '' --- --- ##### shortDescription -Specifies the label of the Appointment popup window field that allows end users to assign a resource of this kind. +Specifies a resource label. --- +Scheduler displays resource labels in the appointment edit form. + +To customize the appointment edit form and add resource items in the **editing**.**form**.[items[]](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#items) array, implement resource labels in item names. Scheduler generates predefined editing form items as follows: + + 'ResourceLabelGroup' + ├─ 'ResourceLabelIcon' + └─ 'ResourceLabelEditor' + #include btn-open-demo with { href: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/Scheduler/Resources/" } \ No newline at end of file From 1382ac6a62fe438e461a1d1b626e510fbcc218bd Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Thu, 20 Nov 2025 18:17:21 +0400 Subject: [PATCH 3/9] Update terminology for group --- .../1 Configuration/editing/form/iconsShowMode.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md index ab83ce62c4..733867e15a 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md @@ -8,13 +8,13 @@ default: 'main' Configures icon visibility within the Appointment Edit Form. --- -The Scheduler Appointment Edit Form consists of two parts: a general information form and a recurrence settings form. Implement [AppointmentFormIconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Types/#AppointmentFormIconsShowMode) values to configure icon visibility as follows: +The Scheduler Appointment Edit Form consists of two parts: a general information group and a recurrence settings group. Implement [AppointmentFormIconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Types/#AppointmentFormIconsShowMode) values to configure icon visibility as follows: - *"both"* -Icons are visible in both general information and recurrence settings forms. +Icons are visible in both general information and recurrence settings groups. - *"main"* -Icons are visible in the general information form only. +Icons are visible in the general information group only. - *"recurrence"* -Icons are visible in the recurrence settings form only. +Icons are visible in the recurrence settings group only. - *"none"* -Icons are hidden in both forms. +Icons are hidden in both groups. From cb277011b328a20007218e62edfc4fcd6e7b8578 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Fri, 21 Nov 2025 16:21:27 +0400 Subject: [PATCH 4/9] Update following feedback --- .../9 Types/AppointmentFormIconsShowMode.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md b/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md index 6dd7ae0063..46965906c6 100644 --- a/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md +++ b/api-reference/10 UI Components/dxScheduler/9 Types/AppointmentFormIconsShowMode.md @@ -9,13 +9,13 @@ references: dxScheduler.Options.editing.form.iconsShowMode Specifies icon visibility within the Appointment Edit Form. --- -The Scheduler Appointment Edit Form consists of two parts: a general information form and a recurrence settings form. Implement **AppointmentFormIconsShowMode** values in **editing**.**form**.[iconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#iconsShowMode) to configure icon visibility as follows: +The Scheduler Appointment Edit Form consists of two parts: a general information group and a recurrence settings group. Implement **AppointmentFormIconsShowMode** values in **editing**.**form**.[iconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#iconsShowMode) to configure icon visibility as follows: - *"both"* -Display icons in both general information and recurrence settings forms. +Display icons in both general information and recurrence settings groups. - *"main"* -Display icons in the general information form only. +Display icons in the general information group only. - *"recurrence"* -Display icons in the recurrence settings form only. +Display icons in the recurrence settings group only. - *"none"* -Hide icons in both forms. +Hide icons in both groups. From 4178d2ca1cb02a1877fd4525858a24b4526eb071 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 24 Nov 2025 11:32:58 +0400 Subject: [PATCH 5/9] Update api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md --- .../dxScheduler/1 Configuration/resources/label.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md index ac9acf83b8..d0e6505660 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/resources/label.md @@ -10,7 +10,7 @@ Specifies a resource label. --- Scheduler displays resource labels in the appointment edit form. -To customize the appointment edit form and add resource items in the **editing**.**form**.[items[]](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#items) array, implement resource labels in item names. Scheduler generates predefined editing form items as follows: +To customize the appointment edit form and add resource items in the **editing**.**form**.[items[]](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/editing/form/#items) array, use resource labels in item names. Scheduler generates predefined editing form items as follows: 'ResourceLabelGroup' ├─ 'ResourceLabelIcon' From 1c8d0119c6f791e90662061a3c179dd27be6f717 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 24 Nov 2025 13:20:12 +0400 Subject: [PATCH 6/9] Update tree --- .../1 Configuration/editing/form/items.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md index 741a3072c8..473c93eac9 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md @@ -15,25 +15,25 @@ The following predefined items are available in the Appointment Edit Form: | ├─ subjectGroup | │ ├─ subjectIcon | │ └─ subjectEditor - | └─ dateGroup - | ├─ dateIcon - | ├─ allDayEditor - | ├─ startDateGroup - | │ ├─ startDateTimeGroup - | │ │ ├─ startDateEditor - | │ │ └─ startTimeEditor - | │ └─ startDateTimezoneEditor - | ├─ endDateGroup - | │ ├─ endDateTimeGroup - | │ │ ├─ endDateEditor - | │ │ └─ endTimeEditor - | │ └─ endDateTimezoneEditor - | ├─ repeatGroup - | │ ├─ repeatIcon - | │ └─ repeatEditor - | └─ descriptionGroup - | ├─ descriptionIcon - | └─ descriptionEditor + | ├─ dateGroup + | │ ├─ dateIcon + | │ ├─ allDayEditor + | │ ├─ startDateGroup + | │ │ ├─ startDateTimeGroup + | │ │ │ ├─ startDateEditor + | │ │ │ └─ startTimeEditor + | │ │ └─ startDateTimezoneEditor + | │ └─ endDateGroup + | │ ├─ endDateTimeGroup + | │ │ ├─ endDateEditor + | │ │ └─ endTimeEditor + | │ └─ endDateTimezoneEditor + | ├─ repeatGroup + | │ ├─ repeatIcon + | │ └─ repeatEditor + | └─ descriptionGroup + | ├─ descriptionIcon + | └─ descriptionEditor └─ recurrenceGroup ├─ recurrenceStartDateGroup │ ├─ recurrenceStartDateIcon From 2dd1e0648e268b2c1eb46d3334c99813e37a9c82 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 24 Nov 2025 13:36:54 +0400 Subject: [PATCH 7/9] Update tree --- .../1 Configuration/editing/form/items.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md index 473c93eac9..8e24d189fb 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md @@ -40,12 +40,12 @@ The following predefined items are available in the Appointment Edit Form: │ └─ recurrenceStartDateEditor ├─ recurrenceRuleGroup │ ├─ recurrenceRuleIcon - │ ├─ recurrenceRuleRepeatGroup - │ ├─ recurrenceCountEditor - │ ├─ recurrencePeriodEditor - │ └─ recurrenceDayOfYearGroup — recurrenceDaysOfWeekEditor — recurrenceDayOfMonthEditor - │ ├─ recurrenceDayOfYearMonthEditor - │ └─ recurrenceDayOfYearDayEditor + │ └─ recurrenceRuleRepeatGroup + │ ├─ recurrenceCountEditor + │ ├─ recurrencePeriodEditor + │ └─ recurrenceDayOfYearGroup — recurrenceDaysOfWeekEditor — recurrenceDayOfMonthEditor + │ ├─ recurrenceDayOfYearMonthEditor + │ └─ recurrenceDayOfYearDayEditor └─ recurrenceEndGroup ├─ recurrenceEndIcon └─ recurrenceEndEditor From 2db50b30ada49cc283cf78866344a4c00dd2addc Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Mon, 24 Nov 2025 17:54:36 +0400 Subject: [PATCH 8/9] Apply suggestions from code review Co-authored-by: dirkpieterse --- .../dxScheduler/1 Configuration/editing/form/form.md | 2 +- .../dxScheduler/1 Configuration/editing/form/iconsShowMode.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md index 841d7e42c2..e533228c55 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/form.md @@ -5,7 +5,7 @@ default: undefined --- --- ##### shortDescription -Configures the [Form](/Documentation/Guide/UI_Components/Form/Overview/) component within the Scheduler appointment edit form. +Configures the [Form](/Documentation/Guide/UI_Components/Form/Overview/) component within the Scheduler's appointment edit form. --- In addition to **editing**.**form** properties, you can specify DevExtreme [Form](/Documentation/Guide/UI_Components/Form/Overview/) configuration options to customize the appointment edit form. \ No newline at end of file diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md index 733867e15a..a7f152d2a3 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/iconsShowMode.md @@ -8,7 +8,7 @@ default: 'main' Configures icon visibility within the Appointment Edit Form. --- -The Scheduler Appointment Edit Form consists of two parts: a general information group and a recurrence settings group. Implement [AppointmentFormIconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Types/#AppointmentFormIconsShowMode) values to configure icon visibility as follows: +The Scheduler's Appointment Edit Form consists of two parts: a general information group and a recurrence settings group. Implement [AppointmentFormIconsShowMode](/Documentation/ApiReference/UI_Components/dxScheduler/Types/#AppointmentFormIconsShowMode) values to configure icon visibility as follows: - *"both"* Icons are visible in both general information and recurrence settings groups. From 21d7657dd3e4be35be703dea2b4da3c55ec6cac4 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Tue, 25 Nov 2025 10:22:39 +0400 Subject: [PATCH 9/9] Update api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md --- .../dxScheduler/1 Configuration/editing/form/items.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md index 8e24d189fb..7d7a201d34 100644 --- a/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md +++ b/api-reference/10 UI Components/dxScheduler/1 Configuration/editing/form/items.md @@ -5,7 +5,7 @@ default: [] --- --- ##### shortDescription -Configures Appointment Edit Form items. +Configures items within the appointment edit form. --- The following predefined items are available in the Appointment Edit Form: