Editorial review: Add docs for scroll-target-group

[chrisdavidmills]

Description

Chrome 140 adds support for the scroll-target-group property; see https://chromestatus.com/feature/5189126177161216.

This PR adds documentation and examples for this property, and links all the things.

Motivation

Additional details

Related issues and pull requests

[github-actions]

Preview URLs (6 pages)

• /en-US/docs/Web/CSS/::scroll-marker-group
• /en-US/docs/Web/CSS/::scroll-marker
• /en-US/docs/Web/CSS/CSS_overflow/CSS_carousels
• /en-US/docs/Web/CSS/CSS_overflow
• /en-US/docs/Web/CSS/scroll-marker-group
• /en-US/docs/Web/CSS/scroll-target-group

Flaws (1)

Note! 5 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/CSS/CSS_overflow/CSS_carousels
Title: Creating CSS carousels
Flaw count: 1

• unknown:
  • Error parsing /shared-assets/images/diagrams/css/carousels/carousel.svg: No such file or directory (os error 2)

(comment last updated: 2025-09-04 07:33:30)

[danielsakhapov]

Overall the text and the examples look good and communicate clearly the idea of this property.

Though, instead of saying:

The scroll-target-group CSS property specifies whether a container element is a scroll marker group.

Could you use a definition from the spec:

The scroll-target-group property specifies whether the element is a scroll marker group container.

And change this wording throughout the rest of the text as well, as this property doesn't really make an element a scroll marker group (not even sure you can say it about an element).

And also:

Note: A scroll marker group can be created from an existing element container using scroll-target-group.

Maybe instead explicitly say that you can create it from an existing set of html anchor elements + container?

@flackr Could you have a quick look, please.

[chrisdavidmills]

Overall the text and the examples look good and communicate clearly the idea of this property.

Though, instead of saying:

The scroll-target-group CSS property specifies whether a container element is a scroll marker group.

Could you use a definition from the spec:

The scroll-target-group property specifies whether the element is a scroll marker group container.

And change this wording throughout the rest of the text as well, as this property doesn't really make an element a scroll marker group (not even sure you can say it about an element).

OK, so basically the issue is that we are creating a container for the scroll marker group, not the scroll marker group itself (as this is just the group of scroll markers collected together inside the container)? I've updated the wording throughout. This was an issue on some of the existing CSS carousel content too.

And also:

Note: A scroll marker group can be created from an existing element container using scroll-target-group.

Maybe instead explicitly say that you can create it from an existing set of html anchor elements + container?

OK, makes sense. I've changed such instances to say that anchor elements are needed inside the container, as well as the container.

[chrisdavidmills]

Thanks for the review, @danielsakhapov. Let me know if you spot any other issues that need attention.

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[flackr]

This looks good to me as well, thanks for looping me in!

[chrisdavidmills]

This looks good to me as well, thanks for looping me in!

@flackr awesome, thanks for giving it a look!