Skip to content

[CSS] view-transition-class <custom-ident> value description is wrong #43784

@TGianella

Description

@TGianella

MDN URL

https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/view-transition-class

What specific section or headline is this issue about?

Values

What information was incorrect, unhelpful, or incomplete?

The description of value seems derived from the definition of the value of view-transition name which brings one major and one minor issue:

  • Everything after the first sentence ("The identifier must be unique. If two rendered elements have the same view-transition-name at the same time, ViewTransition.ready will reject and the transition will be skipped.") is not true for view-transition-class or not relevant if we are talking about view-transition-name.
  • As for the first sentence ("An identifying name that causes the selected element to participate in a separate view transition from the root view transition.", I'm not sure it is technically correct. Having a unique view-transition-name is what will cause the separate view-transition by creating a new view-transition-group. The description section explains that clearly.

The original issue I had with this article is that I was looking to see if if the property supported multiple custom-ident and I overlooked the "+" on the formal syntax. The rest of the article (like the introduction sentence: "The view-transition-class CSS property provides the selected elements with an identifying class" (my emphasis)) seemed to indicate that only one custom-ident was supported.

What did you expect to see?

  • No mentions of a required uniqueness of the custom-ident because it is false
  • The description of the value should indicate that the value is only used to bind the element to a .custom-ident argument to the ::view-transition-group(), ::view-transition-image-pair(), ::view-transition-old(), and ::view-transition-new() pseudo-elements.
  • I thought it would be nice to explicitly specify that the property supports several values and maybe add an example with several custom-ident.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

I would like to take this issue as an opportunity to contribute to MDN. I think I can handle removing the content that is plain wrong (most urgent issue IMO), and also suggest changes to the content in a second time.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Content:CSSCascading Style Sheets docsContent:WebAPIWeb API docsneeds triageTriage needed by staff and/or partners. Automatically applied when an issue is opened.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions