scroll
Scroll a labeled element into view or scroll the page by one viewport
Bring off-screen controls into view, or scroll the page vertically by one viewport.
Syntax
When I scroll to "<target>"
And I scroll down
And I scroll upQualifiers
| Qualifier | Role | Example |
|---|---|---|
to | Scroll labeled element into view | scroll to "Submit" |
down | Scroll down one viewport | scroll down |
up | Scroll up one viewport | scroll up |
Requirements
| Item | Contract |
|---|---|
| Element / control shape | scroll to — general resolve (any labeled control). scroll down / scroll up — no element (window scroll) |
| How the label binds | to label uses ResolveByLabel |
| Qualifiers that change resolve | to vs bare down / up |
| Platform | Web |
| Wrong shape → use instead | N/A for page scroll |
See also UI contracts.
Examples
When I scroll to "Submit order"
And I scroll down
And I scroll up
When I scroll to "Next page"
When I click on "Next page"