docs: fast visibility scrolls off-screen elements into view#6434
Open
mschile wants to merge 3 commits into
Open
docs: fast visibility scrolls off-screen elements into view#6434mschile wants to merge 3 commits into
mschile wants to merge 3 commits into
Conversation
Updates the experimentalFastVisibility documentation to reflect that elements below the fold are automatically scrolled into view per the scrollBehavior config before visibility is checked, matching the behavior of action commands like cy.click(). Elements positioned outside the scrollable document bounds (e.g. negative absolute positioning) cannot be scrolled into view and remain hidden. Pairs with cypress-io/cypress#33736.
2 tasks
cypress-documentation
 |
||||||||||||||||||||||||||||||||||||||||
| Project |
cypress-documentation
|
| Branch Review |
mschile/fast-visibility-scroll-into-view
|
| Run status |
|
| Run duration | 06m 45s |
| Commit |
|
| Committer | Matt Schile |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
 |
0
|
 |
0
|
 |
0
|
 |
0
|
 |
322
|
| View all changes introduced in this branch ↗︎ | |
UI Coverage
47.51%
|
|
|---|---|
|
|
337
|
|
|
3
|
Accessibility
96.88%
|
|
|---|---|
|
|
1 critical
3 serious
4 moderate
1 minor
|
|
|
37
|
Elements inside overflow: hidden / clip ancestors are not scrolled into view, since scrollIntoView would programmatically scroll the clipping container and expose content the test author intentionally clipped. Pairs with cypress-io/cypress#33736.
cacieprins
approved these changes
May 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the
experimentalFastVisibilitydocumentation to reflect a behavior change in Cypress 15.15.0: elements below the fold are now automatically scrolled into view per thescrollBehaviorconfig before visibility is checked, matching the behavior of action commands likecy.click().Elements positioned outside the scrollable document bounds (e.g.
position: absolute; top: -100px) cannot be scrolled into view and continue to be reported as hidden.Pairs with cypress-io/cypress#33736, which fixes cypress-io/cypress#33045.
Pages updated
docs/app/core-concepts/interacting-with-elements.mdx— Updated the "It is positioned fully outside of the browser viewport" bullet, removed the obsolete viewport limitation, and rewrote the "Elements Outside Viewport" compatibility issue.docs/app/references/experiments.mdx— Removed the obsolete viewport caution note.Note
Low Risk
Low risk documentation-only updates that adjust guidance around
experimentalFastVisibilitysemantics (auto-scrolling below-the-fold viascrollBehavior) and remove an obsolete limitation note.Overview
Updates
experimentalFastVisibilitydocs to reflect that elements below the fold are now auto-scrolled into view according toscrollBehaviorbefore visibility is checked (matching action commands), while elements outside scrollable document bounds remain hidden.Removes outdated statements claiming viewport visibility is not handled yet, and expands the “Elements Outside Viewport” compatibility guidance (including behavior under
overflow: hidden/clip).Reviewed by Cursor Bugbot for commit 229a09d. Bugbot is set up for automated code reviews on this repo. Configure here.