Intent to Ship: @scroll-state scrolled support

[Munira Tursunova]

Contact emails

moo...@google.com, moo...@chromium.org

Explainer

https://github.com/w3c/csswg-drafts/blob/main/css-conditional-5/scroll_state_explainer.md#scrolled

Specification

https://drafts.csswg.org/css-conditional-5/#scrolled

Summary

Allows authors to style descendants of containers based on the most recent scrolling direction. Example: 

.scrolling-up { 

    translate: 80px 0;

    transition: 0.4s translate; 

}

html {

    container-type: scroll-state;

}

@container scroll-state(scrolled: top) {

    .scrolling-up { translate: 0 0; }

}

Blink component

Blink>CSS

Web Feature ID

None

Search tags

@scroll-state, scrolled, scroll-direction, scroll-state-container-queries

TAG review

https://github.com/w3ctag/design-reviews/issues/1153

TAG review status

Pending

Risks

Interoperability and Compatibility

None

Gecko: No signal (https://github.com/mozilla/standards-positions/issues/1296)

WebKit: No signal (https://github.com/WebKit/standards-positions/issues/548)

Web developers: Positive (https://github.com/w3c/csswg-drafts/issues/6400)

Other signals:

WebView application risks

Does this intent deprecate or change behavior of existing APIs, such that it has potentially high risk for Android WebView-based applications?

None

Debuggability

Inspectable in DevTools same way as other scroll-state() features like stuck, sticky and scrollable.

Will this feature be supported on all six Blink platforms (Windows, Mac, Linux, ChromeOS, Android, and Android WebView)?

Yes

Is this feature fully tested by web-platform-tests?

Yes
https://wpt.fyi/results/css/css-conditional/container-queries/scroll-state?label=master&label=experimental&aligned&q=scrolled

Flag name on about://flags

CSSScrolledContainerQueries

Finch feature name

CSSScrolledContainerQueries

Rollout plan

Will ship enabled for all users

Requires code in //chrome?

False

Tracking bug

https://issues.chromium.org/issues/414556050

Estimated milestones

Shipping on desktop	144
Shipping on Android	144
Shipping on WebView	144

Anticipated spec changes

Open questions about a feature may be a source of future web compat or interop issues. Please list open issues (e.g. links to known github issues in the project for the feature specification) whose resolution may introduce web compat/interop risk (e.g., changing to naming or structure of the API in a non-backward-compatible way).

None

Link to entry on the Chrome Platform Status

https://chromestatus.com/feature/5083137520173056?gate=5149990699401216

Links to previous Intent discussions

Intent to Prototype: https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CAAO7W_DM7OiUQFuZkeTn%2B%2B%3DDt_grrggNR%3DVOPbGxECbPW40_Sw%40mail.gmail.com

This intent message was generated by Chrome Platform Status.

[Vladimir Levin]

LGTM1

Thanks

On Wednesday, October 8, 2025 at 7:03:45 AM UTC-4 moo...@google.com wrote:

Contact emails

moo...@google.com, moonira@chromium.org

[Alex Russell]

LGTM2

[Mike Taylor]

LGTM3 - cool feature.

--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.
To view this discussion visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/79ed2bcd-8179-4f10-83ae-8c47826a0d83n%40chromium.org.