Scroll to Today on Load - Nextedy Documentation

The Gantt toolbar includes a Go to today button that scrolls the timeline to the current date with a single click. You can also access this action by right-clicking on the time scale header area and selecting the scroll-to-today option from the context menu.

Scroll to Today Automatically on Load

To make the Gantt always center on today’s date when the page loads, add a script to the Gantt Config Script:

Open the Polarion page containing the Gantt widget
Edit the widget properties
Navigate to Advanced > Gantt Config Script
Add one of the following scripts:

Option 1 — Scroll after all data loads:

gantt.attachEvent("onLoadEnd", function() {
    gantt.showDate(new Date());
});

Option 2 — Scroll after each render cycle:

gantt.attachEvent("onDataRender", function() {
    gantt.showDate(new Date());
});

Use onLoadEnd if you want the scroll to happen once when data finishes loading. Use onDataRender if you want the view to re-center after every render (for example, after filtering or expanding/collapsing tasks). For most use cases, onLoadEnd is sufficient.

Configure the Today Marker

The today marker is a vertical line on the Gantt timeline indicating the current date. You can show or hide it using the showTodayMarker widget parameter.

Parameter	Default	Description
`showTodayMarker`	`true`	Display a vertical line on today’s date
`nextedy.gantt.today.color`	`gray`	Color of the today marker (administration property)

To hide the today marker:

Edit the widget properties
Navigate to Advanced > Show Today Marker
Set it to No

The today marker position is determined by the server’s date and time, not the user’s local time. If your Polarion server is in a different timezone than your users, the today marker may appear to be a day off. This is expected behavior. See Troubleshooting Today Marker Position for details.

Combine with Collapse on Load

A common configuration pattern combines scroll-to-today with starting the Gantt in a collapsed state. To start with all task groups collapsed, add the following to your Item Script:

task.open = false;

This collapses all parent tasks on load. Users can then expand groups as needed while the timeline is already centered on today’s date.

Verify Your Configuration

Reload the Polarion page containing the Gantt widget
You should now see the timeline automatically scrolled so that today’s date is in the visible area
If showTodayMarker is enabled, a vertical line marks today’s date on the timeline
Click the Go to today toolbar button to confirm it scrolls to the same position

​Use the Toolbar Button

​Scroll to Today Automatically on Load

​Configure the Today Marker

​Combine with Collapse on Load

​Verify Your Configuration

​See Also

Use the Toolbar Button

Scroll to Today Automatically on Load

Configure the Today Marker

Combine with Collapse on Load

Verify Your Configuration

See Also