What does "nearest" mean for scrollBehavior?

[verheyenkoen]

Subject

Guides

Description

The Actionabiliy page (and a few other pages) mentions the "nearest" option for scrollBehavior but I can't find a definition for that. Does that mean the parent node (like "closest" in jQuery/Cypress)? The other options are more self-descriptive but "nearest" is a bit smoky so I'd like that clarified.

[litera]

I haven't noticed aby documentation change that would clear these things up. So what is the meaning of nearest then?

[verheyenkoen]

FYI: I just got familiar with the scrollIntoView method and -I assume- this relates to the block option from that method that has the same options. Possibly both block and inline are set with this option.

So this defines how the scrollable container behaves when moving the hidden element into view in the "block"-dimension (usually vertical). Nearest would mean it brings the element fully into view on the nearest side. Think of: the minimum amount of scrolling needed to bring it into view. So if the element was below the scrollable viewport it will scroll it to the bottom. If it was above the scrollable viewport, it will scroll it to the top.

Still think the docs could be approved to at least link to the MDN page for the scrollIntoView() method.