Create a new OverflowAxis that allows scrolling while keeping overflown items visible

[hukasu]

Objective

If you want to create a node that has a long list of items, have all of them visible and scroll through them, you would need to fiddle with Node::left or Node::right

Solution

Create OverflowAxis::ScrollNoClip that keeps all items visible and allows you to scroll using ScrollPosition

Showcase

overflow_scroll example

[github-actions]

It looks like your PR has been selected for a highlight in the next release blog post, but you didn't provide a release note.

Please review the instructions for writing release notes, then expand or revise the content in the release notes directory to showcase your changes.

[viridia]

you would need to fiddle with Node::left or Node::right

Why is that so bad? I think you need a clearer justification for this change.

[hukasu]

Using ScrollPosition you don't need to check for the bounds, as it is already dealt with by bevy

[ickshonpe]

I'm not very convinced either. The overflow implementation isn't complete, overflow-scroll is meant to display scrollbars. Once we implement scroll bars, a "ScrollNoClip" variant doesn't make any sense.

[hukasu]

The scrollbars will be required by all ui nodes, not opt-in?

[hukasu]

Looking at the screenshots you will see that all 3 have a ui node that is 128x128, using ScrollNoClop I can just use ScrollPosition to scroll until it starts clamping, if I were to use Visible and move using Node::left or Node::right I would need to query for the window size, calculate the offset by hand, and then clamp, all things that are already done on Scroll

[hukasu]

Updated the example to include a border to show the UI Node

[viridia]

Looking at the screenshot, it seems like you are trying to create a diegetic user interface. If that's the case, then perhaps bevy_ui isn't the right framework? Maybe you want to use actual pickable 3d objects?

In any case, this seems like a very niche use case, and given that there's a (admittedly more complex) workaround, I'm not sure it's worth it adding to Bevy engine. (There's another argument I could make, but this involves an etymological argument about the definition of the word "scroll" which I'd rather not get into.)

On the question of scrollbars: I've been assuming that games will want to customize the look and feel of scrollbars, so I've been wary of the idea of automatically adding scrollbars to scrolling entities.

[hukasu]

my idea is

[hukasu]

See also
https://discord.com/channels/691052431525675048/692572690833473578/1385061562024460469
#19771

[ickshonpe]

On the question of scrollbars: I've been assuming that games will want to customize the look and feel of scrollbars, so I've been wary of the idea of automatically adding scrollbars to scrolling entities.

It's not so much about about displaying the scrollbars themselves. It's about controlling the non-visual layout behaviour like:

• Whether scrollbars should occupy space in the space in the layout or float above the container.
• Automatically allocating space for the scrollbar gutters when content overflows.
• Stable scroll positions with anchoring so content doesn't shift when it changes size.

Problems which our current scrolling implementation just completely ignores 😓

[hukasu]

i don't want this discussion to devolve into a discussion about scrollbars, but i would like for scrollbars to be able to be placed anywhere, even on a separate UI hierarchy, probably using relationships, i.e. TrackingScrollOf, ScrollTrackedBy

[hukasu]

and back to this PR, what alternative do y'all suggest then? Overflow::scroll with OverflowMargin set to u32::MAX?