Skip to main content

GUI: Web Page Scroll

Description

Web Page Scroll scrolls the web page to bring a specific element into view. Use this step when the element you need to interact with is not visible on the screen and requires scrolling to reach — for example, a button at the bottom of a long form or a table row below the fold. You specify the target element using criteria and a criteria value, and the step automatically scrolls the page in whatever direction is needed until the element is visible. It also supports targeting elements inside iframes.

Configurations

Field NameDescription
Step NameName of the step. This name has to be unique in a single workflow.The data type is String and the field is mandatory.
Web Browser NameSelect Web Browser Name from the given list.Note: Select the same web browser name which was selected in Start Browser Step.
Criteria‘Criteria’ is the criterion to locate elements on Web GUI. GUI Spy can capture it in the Generate Step dialog. Upon Step Generation, it is populated in the step configuration. You may change criteria by choosing from the drop-down list in the ‘Step Generation’ window or step configuration.
Criteria ValueRelevant criteria value has to be specified.
Element Index(Starts with 0)Specify the index of the element you want to locate.
Note: One can also specify First or Last. First, if you want the first element from the located element or specify Last if you want the last element.Default Value: 0.
Iframe IndicesSpecify Iframe Indices value. Specifying iframe indices ensures that the target element is identified correctly within the nested frame structure.
You can provide comma-separated values. For e.g. 0,1,2.
Iframe XpathIframe Xpath is a uniquely generated path that represents the location of an <iframe> or <frame> relative to the top-level window.

Iframe Xpath identifies each frame using a unique attribute such as id, name, or title if available, for example, iframe[@id='mainFrame'].

If no such attributes exist, the frame is identified by its position among sibling frames, like iframe[2] for the second iframe.

For nested structures, each frame is joined in sequence to form a full path. For example, if an element is inside an iframe[@id='outer'], which contains a frameset with a frame[@name='middle'], and that frame contains iframe[@title='inner'], the generated path would be:
iframe[@id='outer'];frame[@name='middle'];iframe[@title='inner'].

Note: If an iframe or frame has no id, name, or title, its origin (i.e., the src URL) will be used as a fallback in the path for unique identification. For example: iframe[@origin='https://example.com'].
Frame IDProvide the current Iframe Id to target a specific iframe to perform the action.
Default Value: frameID