Skip to content

Update animation property documentation for clarity#43645

Open
estelle wants to merge 5 commits intomainfrom
estelle-patch-5
Open

Update animation property documentation for clarity#43645
estelle wants to merge 5 commits intomainfrom
estelle-patch-5

Conversation

@estelle
Copy link
Copy Markdown
Member

@estelle estelle commented Apr 2, 2026

Clarified the specification of the animation property, detailing the components and their order. Updated notes on animation-timeline and animation-fill-mode behavior.

animation-range-start and animation-range-end were listed as part of the shorthand, but they aren't, and they aren't reset by the shorthan.

Clarified the specification of the `animation` property, detailing the components and their order. Updated notes on `animation-timeline` and `animation-fill-mode` behavior.
@estelle estelle requested a review from a team as a code owner April 2, 2026 01:01
@estelle estelle requested review from chrisdavidmills and removed request for a team April 2, 2026 01:01
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Apr 2, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Preview URLs (1 page)

Flaws (1)

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/CSS/Reference/Properties/animation
Title: animation
Flaw count: 1

  • broken_links:
    • Link /en-US/docs/Web/CSS/Reference/Values/number-token doesn't resolve

(comment last updated: 2026-04-02 09:59:31)

chrisdavidmills and others added 3 commits April 2, 2026 08:56
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

@chrisdavidmills chrisdavidmills left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@estelle looking much improved, nice work. I've got some comments for you.


One or more single `<animation>` declarations, separated by commas, with each `<animation>` including:

- `<single-animation-name>`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You should check the type names in the spec to make sure they match with the ones stated here. For example, <keyframes-name> now seems to be used in place of <single-animation-name>.


### Values

One or more single `<animation>` declarations, separated by commas, with each `<animation>` including:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The order of the components being used in the constituent properties list, the syntax examples, and the values list seems to differ. Would it be more intuitive to make them all the same, and make them equal to the recommended order to place the components in?

- The names of a {{cssxref("@keyframes")}} at-rules that describes the animation to apply to an element. The initial value for {{cssxref("animation-name")}} is `none`.
- `<single-easing-function>`
- : Determines the type of transition. The value must be one of those available in {{cssxref("easing-function")}}.
- : Determines the type of transition. The value must be one of those available in {{cssxref("easing-function")}}. The initial value for {{cssxref("animation-timing-function")}} is `ease`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- : Determines the type of transition. The value must be one of those available in {{cssxref("easing-function")}}. The initial value for {{cssxref("animation-timing-function")}} is `ease`.
- : Determines the type of transition. The value must be one of those available in {{cssxref("easing-function")}}. The initial value for {{cssxref("easing-function")}} is `ease`.

- `<single-animation-play-state>`
- : Determines whether the animation is playing or not. The value must be one of those available in {{cssxref("animation-play-state")}}.
- : Determines whether the animation is playing or not. The value must be one of those available in {{cssxref("animation-play-state")}}. The initial value for {{cssxref("animation-play-state")}} is `running`.
- `<single-animation-delay>`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Say what the value must be for these two additions to be consistent with the other components?


One or more single `<animation>` declarations, separated by commas, with each `<animation>` including:

- `<single-animation-name>`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<animation-timeline> is not included in this list.


One or more single `<animation>` declarations, separated by commas, with each `<animation>` including:

- `<single-animation-name>`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ooop, also, by the looks of the preview doc, the DL formatting looks broken.

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants