[update] info on sticky labels & update constraints

Author: AlexKlimenkov

data/api/gantt_auto_scheduling_config.md

@@ -4,8 +4,8 @@ auto_scheduling
 @short:
 	enables auto scheduling
 
-@type: boolean
-@default:false
+@type: boolean | object
+@default: false
 @example:
 gantt.config.auto_scheduling = true;
 
@@ -19,6 +19,20 @@ gantt.init("gantt_here");
 {{note This config is defined in the **auto_scheduling** extension, so you need to activate the [auto_scheduling](desktop/extensions_list.md#autoscheduling) plugin. Read the details in the desktop/auto_scheduling.md article.}}
 
 
+The `auto_scheduling` config can be set as a boolean or as an object to enable additional control over the auto-scheduling behavior. When set as an object, the following options are available:
+
+- **enabled** (*boolean*) - turns auto-scheduling on or off (same as using a boolean value directly).
+- **show_constraints** (*boolean*) - controls the display of task constraints on the Gantt chart. Set to `true` to display constraints or `false` to hide them.
+
+For example, to enable auto-scheduling but disable the display of task constraints:
+
+~~~js
+gantt.config.auto_scheduling = {
+  enabled: true,
+  show_constraints: false
+};
+gantt.init("gantt_here");
+~~~
 
 @related:
 desktop/auto_scheduling.md

data/desktop/configuring_time_scale.md

@@ -721,3 +721,28 @@ And here is how it looks when they are shown (**gantt.config.skip_off_time** is
 
 You can find detailed examples on how to implement an infinite scroll in the timeline in the [related](desktop/how_to.md#howtohaveaninfinitescrollinthetimeline) article.
 
+## Sticky labels
+
+Starting from v9.0, time scale labels are sticky by default. This means that when the width of a cell is significantly larger than the width of its label, the label will remain visible as you scroll through the timeline, staying attached to the viewport until it naturally scrolls off. This improves the visibility of scale labels, particularly when zoomed in or out.
+
+To revert to the old behavior where labels are centered within their cells and do not remain visible while scrolling, you can disable sticky labels by setting the `sticky` property of the scale object to `false`:
+
+~~~js
+gantt.config.scales = [
+  {unit: "year", step: 1, format: "%Y", sticky: false},
+  {unit: "month", step: 1, format: "%F", sticky: false},
+  {unit: "day", step: 1, format: "%j", sticky: false}
+];
+gantt.init("gantt_here");
+~~~
+
+You can also force sticky labels for a particular scale regardless of cell width by setting `sticky: true`. This will ensure the labels are always sticky, even when the label width is smaller than the cell width:
+
+~~~js
+gantt.config.scales = [
+  {unit: "year", step: 1, format: "%Y", sticky: true},
+  {unit: "month", step: 1, format: "%F", sticky: true},
+  {unit: "day", step: 1, format: "%j", sticky: true}
+];
+gantt.init("gantt_here");
+~~~

data/desktop/inbuilt_baselines.md

@@ -240,8 +240,33 @@ and if it contains a valid date, the deadline element will be displayed in the t
 
 ### Task constraints
 
-When [auto scheduling](desktop/auto_scheduling.md) is enabled and works in the Constraint mode (api/gantt_auto_scheduling_compatibility_config.md is set to *false*),
-Gantt will automatically display constraint dates in the chart. 
+Starting from v9.0, when [auto scheduling](desktop/auto_scheduling.md) is enabled and works in Constraint mode (api/gantt_auto_scheduling_compatibility_config.md is set to *false*), Gantt will automatically display constraint dates in the chart.
+
+~~~js
+gantt.parse({
+  data: [
+    { 
+      id: 1, 
+      text: "Task #1", 
+      start_date: "2025-04-04", 
+      duration: 4, 
+      constraint_date: "2025-04-04", 
+      constraint_type: "snet", 
+      parent: 0
+    },
+    // Additional tasks
+  ]
+})
+~~~
+
+The display of constraints can be controlled using the `display_constraints` option in the api/gantt_auto_scheduling_config.md config. By default, constraints are shown, but you can disable them by setting `display_constraints` to `false`:
+
+~~~js
+gantt.config.auto_scheduling = {
+  enabled: true,
+  display_constraints: false
+};
+~~~
 
 {{sample 02_extensions/19_constraints_scheduling.html}}
 

data/migrating.md

@@ -148,10 +148,35 @@ you can use the corresponding confguration options: api/gantt_baselines_config.m
 // disabling the built-in baselines functionality
 gantt.config.baselines = false;
 
-// disabling the built-in deadlines and constraints functionality
+// disabling the built-in deadlines functionality
 gantt.config.deadlines = false;
 ~~~
 
+Built-in display of task constraints can also be disabled using the extended api/gantt_autoscheduling_config.md config:
+
+~~~js
+gantt.config.auto_scheduling = {
+  enabled: true, 
+  show_constraints: false
+};
+~~~
+
+This disables the default display of task constraints while still keeping auto-scheduling functionality active.
+
+### Sticky labels in the Timeline
+
+Starting from v9.0, time scale labels are sticky by default. This means the labels stay visible on the screen as you scroll, following the viewport until they scroll off naturally. In previous versions, labels were centered within their cells and did not remain visible while scrolling.
+
+If you need to revert to the old behavior and disable sticky labels, you can set the `sticky` property of the [scale](desktop/configuring_time_scale.md) object to false:
+
+~~~js
+gantt.config.scales = [
+  {unit: "year", step: 1, format: "%Y", sticky: false},
+  {unit: "month", step: 1, format: "%F", sticky: false},
+  {unit: "day", step:1, format: "%j", sticky: false}
+];
+~~~
+
 ### Promise implementation
 
 The **Bluebird** library has been excluded from the Gantt bundle. api/gantt_promise.md now uses the native Promise implementation.

data/whatsnew.md

@@ -13,7 +13,7 @@ If your current version of dhtmlxGantt is older than 2.0, check migrating.md for
 <b>9.0</b>
 ---------------
 
-<span class='release_date'>October 18, 2024. Major update</span>
+<span class='release_date'>October 17, 2024. Major update</span>
 
 [Review of release on the blog](https://dhtmlx.com/blog/dhtmlx-gantt-9-0/)
 
@@ -28,6 +28,7 @@ This update brings some changes in the structure of the Gantt package and behavi
 - New [Dark skin](desktop/skins.md#darkskin) is introduced
 - Built-in support for [Baselines](desktop/baselines.md) is added
 - [Manually Scheduled Summary tasks](desktop/custom_projects_dates.md) are now supported
+- [Sticky labels for time scales](desktop/configuring_time_scale.html#stickylabels)
 
 ### Updates