Skip to main content

Scroll Component into View

Use this action to scroll a specific component into the visible area of the app. This is useful for guiding users to a component after an interaction, for example, scrolling down to a validation error, a newly added table row, or a section that's currently outside the viewport.

Options

OptionDescription
ComponentSelect the target component from the dropdown. Components nested inside a Modal aren't listed here, since they're only rendered when the modal is open.
BehaviourControls the scrolling animation. Smooth (default) animates the scroll, Instant jumps to the component with no animation, and Auto defers to the browser's default scrolling behavior.
BlockControls where the component lands in the viewport once scrolled into view. Nearest (default) scrolls the minimum distance needed to bring it into view, Start aligns it to the top, Center aligns it to the middle, and End aligns it to the bottom.
DebounceDebounce field is empty by default, you can enter a numerical value to specify the time in milliseconds after which the action will be performed. ex: 300
info

You can also trigger actions from the JavaScript code. Check it out here.

Using RunJS query to scroll a component into view

This action can also be triggered via a RunJS query using the following syntax:

actions.scrollComponentInToView("<componentName>");
// replace <componentName> with the name of your component, e.g. text1
info

For instructions on how to run actions from a RunJS query, refer to the how-to guide Running Actions from RunJS Query.

note

The Behaviour and Block options can currently be configured only when adding this action through an event handler in the App Builder. The RunJS syntax above always scrolls using the default (smooth, nearest-aligned) behavior.