Scheduler: Add snapToCellsMode API Desc. by arman-boyakhchyan · Pull Request #8599 · DevExpress/devextreme-documentation

arman-boyakhchyan · 2026-03-24T06:49:58Z

No description provided.

Copilot

Pull request overview

Adds end-user documentation for the snapToCellsMode API in dxScheduler and makes the corresponding enum/type visible (instead of hidden).

Changes:

Moved Enums.SnapToCellsMode doc from _hidden into the public dxScheduler “Types” section and added value descriptions.
Added detailed descriptions (including per-view defaults) to dxScheduler.Options.snapToCellsMode and dxScheduler.Options.views.snapToCellsMode.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
api-reference/_hidden/Enums/SnapToCellsMode.md	Removes the hidden placeholder enum doc.
api-reference/10 UI Components/dxScheduler/9 Types/SnapToCellsMode.md	Adds public enum/type doc with value semantics.
api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md	Documents view-specific `snapToCellsMode` behavior and defaults.
api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md	Documents global `snapToCellsMode` behavior and defaults.

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/9 Types/SnapToCellsMode.md

Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

Copilot · 2026-03-31T07:32:32Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

+Specifies how the Scheduler component snaps appointments to grid (applies to all view types).

 ---
-<!-- Description goes here -->
+If a Scheduler is bound to a [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#dataSource), it can snap appointments to grid. If this functionality is active, the Scheduler increases appointment dimensions (never shrinks appointments).
+


The phrasing is grammatically incomplete in a few places (for example, “snaps appointments to grid” should be “to the grid”/“to grid cells”), and the first paragraph starts with an introductory dependent clause (“If a Scheduler is bound…, …”). Consider rewriting these sentences to use direct active voice and consistent articles (for example, start with “Bind the Scheduler to a dataSource to enable…”).

Copilot · 2026-03-31T07:32:33Z

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

+Specifies how a Scheduler View snaps appointments to grid.

 ---
-<!-- Description goes here -->
+If a Scheduler is bound to a [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#dataSource), you can snap appointments to grid. If this functionality is active, the Scheduler increases appointment dimensions (never shrinks appointments).
+


Similar to the component-level option, a few sentences are missing articles (“to grid” → “to the grid”/“to grid cells”) and start with an introductory dependent clause (“If a Scheduler is bound…, …”). Consider rewriting for direct active voice (for example, “Bind the Scheduler to a dataSource to enable…”).

Copilot · 2026-03-31T07:32:33Z

api-reference/10 UI Components/dxScheduler/9 Types/SnapToCellsMode.md

+Specifies how Scheduler snaps appointments to grid.
+
+---
+The following **snapToCellsMode** values are available:
+
+- *"always"*: Scheduler snaps all appointments to grid.
+- *"auto"*: Appointments that cover more than half of a cell are stretched to occupy the entire cell.
+- *"never"*: Scheduler does not snap appointments to grid.


The enum’s short description and value descriptions are inconsistent with the corresponding option docs (for example, "always" is described as "Appointments occupy cells fully" here, but the option pages describe snapping behavior; "never" mentions dimension changes instead of snapping). To avoid confusing readers, align the enum’s wording with the option descriptions and use consistent phrasing (for example, “the Scheduler … the grid”).

Suggested change

Specifies how Scheduler snaps appointments to grid.

---

The following **snapToCellsMode** values are available:

- *"always"*: Scheduler snaps all appointments to grid.

- *"auto"*: Appointments that cover more than half of a cell are stretched to occupy the entire cell.

- *"never"*: Scheduler does not snap appointments to grid.

Specifies how the Scheduler snaps appointments to the grid.

---

The following **snapToCellsMode** values are available:

- *"always"*: The Scheduler always snaps appointments to the grid.

- *"auto"*: The Scheduler snaps an appointment to the grid if it occupies more than half of a cell.

- *"never"*: The Scheduler never snaps appointments to the grid.

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md

Co-authored-by: dirkpieterse <dirk.pieterse@devexpress.com>

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

Copilot · 2026-04-02T15:03:59Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

 ---
 ##### shortDescription
-<!-- Description goes here -->
+Specifies how the Scheduler component snaps appointments to the grid (applies to all view types).


In this short description, "snaps appointments to grid" is missing the article "the". For consistency with the view-level documentation in this PR, consider using "to the grid".

Copilot · 2026-04-02T15:04:00Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md


 ---
-<!-- Description goes here -->
+The Scheduler can snap appointments to the grid. When this feature is enabled, the component increases appointment dimensions and never reduces them.


This sentence is missing the definite article at the beginning. Consider changing "Scheduler can snap..." to "The Scheduler can snap..." to match the style used elsewhere in the Scheduler docs and in the view-level description added in this PR.

Copilot · 2026-04-02T15:04:00Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

+- *"always"*: Scheduler snaps all appointments to the grid.
+- *"auto"*: Appointments that cover more than half of a cell are stretched to occupy the entire cell.
+- *"never"*: Scheduler does not snap appointments to the grid.


These bullet descriptions omit the article in "to grid". For readability and consistency with the view-level snapToCellsMode doc, use "to the grid" in each bullet.

Copilot · 2026-04-02T15:04:00Z

api-reference/10 UI Components/dxScheduler/9 Types/SnapToCellsMode.md

+The following **snapToCellsMode** values are available:
+
+- *"always"*: Scheduler snaps all appointments to the grid.
+- *"auto"*: Appointments that cover more than half of a cell are stretched to occupy the entire cell.


These bullet descriptions omit the article in "to grid". For readability and consistency with the configuration-level docs in this PR, use "to the grid" in each bullet.

Suggested change

- *"auto"*: Appointments that cover more than half of a cell are stretched to occupy the entire cell.

- *"auto"*: Appointments that cover more than half of a cell are snapped to the grid and stretched to occupy the entire cell.

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

Copilot · 2026-04-03T10:54:48Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

 ---
 ##### shortDescription
-<!-- Description goes here -->
+Specifies how the Scheduler component snaps appointments to the grid (applies to all view types).


The shortDescription says this setting "applies to all view types", but the note below states that the "agenda" view ignores this property. Please adjust the shortDescription to exclude agenda (or rephrase to avoid implying it applies to every view type).

Suggested change

Specifies how the Scheduler component snaps appointments to the grid (applies to all view types).

Specifies how the Scheduler component snaps appointments to the grid.

Copilot · 2026-04-03T10:54:49Z

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md

+The default **snapToCellsMode** value varies by view:
+
+<table class="dx-table">
+    <tr>
+        <th>Value</th>
+        <th>Scheduler Views</th>
+    </tr>
+    <tr>
+        <td><i>"never"</i></td>
+        <td><i>"day"</i>, <i>"week"</i>, <i>"workWeek"</i>, <i>"timelineDay"</i>, <i>"timelineWeek"</i>, <i>"timelineWorkWeek"</i></td>
+    </tr>
+    <tr>
+        <td><i>"always"</i></td>
+        <td><i>"month"</i>, <i>"timelineMonth"</i></td>
+    </tr>


This section says the default snapToCellsMode value varies by view, but the table does not mention the "agenda" view (which is called out later as ignoring the property). Consider clarifying that the table applies only to views where snapToCellsMode is respected, or add an explicit agenda entry (for example, "ignored").

Copilot · 2026-04-03T10:54:49Z

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md


 ---
-<!-- Description goes here -->
+The Scheduler can snap appointments to the grid. When this feature is enabled, the component increases appointment dimensions and never reduces them.


"When this feature is enabled" is ambiguous because snapToCellsMode itself controls whether snapping is enabled. Consider explicitly stating which values enable snapping (for example, that snapping is disabled when the value is "never").

Suggested change

The Scheduler can snap appointments to the grid. When this feature is enabled, the component increases appointment dimensions and never reduces them.

The Scheduler can snap appointments to the grid. When **snapToCellsMode** is set to *"always"* or *"auto"*, the component increases appointment dimensions and never reduces them.

Scheduler: Add snapToCellsMode API Desc.

7383738

arman-boyakhchyan self-assigned this Mar 24, 2026

Copilot AI review requested due to automatic review settings March 24, 2026 06:49

arman-boyakhchyan added the 26_1 label Mar 24, 2026

Copilot AI reviewed Mar 24, 2026

View reviewed changes

arman-boyakhchyan added 2 commits March 25, 2026 11:56

Update Table Formatting

5c0aca9

Add Agenda View Info

4e569cf

Copilot AI review requested due to automatic review settings March 26, 2026 11:21

Copilot AI reviewed Mar 26, 2026

View reviewed changes

arman-boyakhchyan added 2 commits March 26, 2026 19:09

Clarify Resizing Behavior

f41831c

Add Further Clarity & Finalize

f92760a

Copilot AI review requested due to automatic review settings March 27, 2026 07:32

Copilot AI reviewed Mar 27, 2026

View reviewed changes

sjbur approved these changes Mar 27, 2026

View reviewed changes

Abadzhev reviewed Mar 30, 2026

View reviewed changes

Apply suggestions from code review

7fbc8b8

Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>

Copilot AI review requested due to automatic review settings March 31, 2026 07:28

Copilot started reviewing on behalf of arman-boyakhchyan March 31, 2026 07:28 View session

Update Following Feedback

e034c59

Copilot AI reviewed Mar 31, 2026

View reviewed changes

Abadzhev reviewed Mar 31, 2026

View reviewed changes

api-reference/10 UI Components/dxScheduler/1 Configuration/views/snapToCellsMode.md Outdated Show resolved Hide resolved

api-reference/10 UI Components/dxScheduler/1 Configuration/snapToCellsMode.md Outdated Show resolved Hide resolved

Add Clarity

8f80ded

dirkpieterse reviewed Apr 2, 2026

View reviewed changes

Apply suggestions from code review

3aa7354

Co-authored-by: dirkpieterse <dirk.pieterse@devexpress.com>

Copilot AI review requested due to automatic review settings April 2, 2026 14:59

Copilot started reviewing on behalf of arman-boyakhchyan April 2, 2026 15:00 View session

Synchronize Following Editors Review

785262e

Copilot AI reviewed Apr 2, 2026

View reviewed changes

arman-boyakhchyan added 2 commits April 3, 2026 11:01

Update Auto Desc.

b319a21

Add Minor Fix

7ea391b

Copilot AI review requested due to automatic review settings April 3, 2026 10:49

Copilot started reviewing on behalf of arman-boyakhchyan April 3, 2026 10:50 View session

Copilot AI reviewed Apr 3, 2026

View reviewed changes

	- "auto": Appointments that cover more than half of a cell are stretched to occupy the entire cell.
	- "auto": Appointments that cover more than half of a cell are snapped to the grid and stretched to occupy the entire cell.

	Specifies how the Scheduler component snaps appointments to the grid (applies to all view types).
	Specifies how the Scheduler component snaps appointments to the grid.

	The Scheduler can snap appointments to the grid. When this feature is enabled, the component increases appointment dimensions and never reduces them.
	The Scheduler can snap appointments to the grid. When snapToCellsMode is set to "always" or "auto", the component increases appointment dimensions and never reduces them.

Conversation

arman-boyakhchyan commented Mar 24, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 3, 2026

Choose a reason for hiding this comment