Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Animatable CSS properties missing list of Animatable CSS properties #28554

Open
Gitoffthelawn opened this issue Aug 14, 2023 · 8 comments
Open
Labels
Content:CSS Cascading Style Sheets docs needs decision The task needs consensus through discussion

Comments

@Gitoffthelawn
Copy link

MDN URL

https://developer.mozilla.org/docs/Web/CSS/CSS_animated_properties

What specific section or headline is this issue about?

Animatable CSS properties

What information was incorrect, unhelpful, or incomplete?

This page previously contained, as its title specifies, a list of links to all animatable CSS properties. That essential list is now missing, rendering this page much less useful.

What did you expect to see?

A list of links to all animatable CSS properties.

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

No response

Do you have anything more you want to share?

Can the list of links to all animatable CSS properties please be restored?

MDN metadata

Page report details
@Gitoffthelawn Gitoffthelawn added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Aug 14, 2023
@github-actions github-actions bot added the Content:CSS Cascading Style Sheets docs label Aug 14, 2023
@wbamberg
Copy link
Collaborator

This is a duplicate of #27042, in which the reasoning for removing the list was given. What is your use case for this list, that isn't met by the formal definition table in the property reference page (e.g. https://developer.mozilla.org/en-US/docs/Web/CSS/clip-path#formal_definition), which indicates how the property is animatable?

@sideshowbarker sideshowbarker added needs info Needs more information to review or act on. and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Aug 17, 2023
@Gitoffthelawn
Copy link
Author

...What is your use case for this list, that isn't met by the formal definition table in the property reference page (e.g. https://developer.mozilla.org/en-US/docs/Web/CSS/clip-path#formal_definition), which indicates how the property is animatable?

When I'm writing new code, debugging my code, or debugging the code of others, a quick reference table is much more useful than having to look up each property.

For example, let's say I want to hide an HTML element. There are many different CSS properties that can be used to accomplish this task (depending on the context). But if one wants to slowly hide an element, the CSS property must be animatable.

With how MDN was written until recently, I could simply go to the above-referenced page and quickly verify which CSS properties are animatable. This took just a couple seconds and minimal energy.

Now that this table has been removed from MDN, I must open a slew of browser tabs (one for each property that I may want to use), manually scroll to the correct position in each tab to find the correct section (or manually search for an identifying string), and then find the same data that previously was clearly presented in a nice and tidy table. After laboriously finding the information, I must now close all those browser tabs (and not accidentally close any other browser tabs).

What previously could be accomplished via a single pointer movement followed by a single toolbar button click now takes more than 20 clicks, scroll actions, and pointer movements. That's a 2000%+ increase. And what previously involved almost zero chance of error, now introduces some error.

I hope this example helps illustrate the benefits of quick reference tables.

@Vallek
Copy link

Vallek commented Sep 6, 2023

@Gitoffthelawn hey in case you didn't see it at #27042 i made a list from specs vallek.github.io/animatable-css/

@Gitoffthelawn
Copy link
Author

@Vallek Thank you ❤️

@yarusome
Copy link
Contributor

yarusome commented Sep 20, 2023

@Gitoffthelawn FWIW, CSS properties that can exhibit slow or whatever gradual animations should not only be animatable, but its animation type should also not be discrete. This common fallacy counts as another reason why the original list was not as useful as it seemed.

@wbamberg Do you think a WebRef-/openwebdocs/project#174-based macro/bot that lists CSS properties by animation types would help?

@wbamberg
Copy link
Collaborator

Sorry to have not got back to you before about this, @Gitoffthelawn . I did read your use case and discussed it a bit internally.

What previously could be accomplished via a single pointer movement followed by a single toolbar button click now takes more than 20 clicks, scroll actions, and pointer movements. That's a 2000%+ increase.

Perhaps I'm not understanding this, but assuming you're checking multiple properties (20 I suppose?) I'm not sure how you could find 20 items in https://web.archive.org/web/20220325145740/https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animated_properties with "a single pointer movement followed by a single toolbar button click".

manually scroll to the correct position in each tab to find the correct section (or manually search for an identifying string)

This isn't needed. Animation support is always in the "Formal definition" table, which is accessible by one click from the table of contents.

Also, I'm not sure how often it will actually come up that you have to check the animation status of 20 properties, all in one go. Finally, as @yarusome says, the list wouldn't have given you reliable answers anyway, as the type of animation is also relevant. So you would have needed to double-check the property page anyway.

@wbamberg Do you think a WebRef-/openwebdocs/project#174-based macro/bot that lists CSS properties by animation types would help?

Certainly this seems like an argument for including animation type in there. It is present in webref.

@wbamberg
Copy link
Collaborator

That said, while I'm not wildly enthusiastic about macros that are very specific to a single page, I'm not totally against them either, if they deliver real value to readers. @yarusome , as you've said, almost all properties are animatable, so it would make more sense to list non-animatable ones, and we could repurpose https://github.com/mdn/yari/blob/main/kumascript/macros/CSSAnimatedProperties.ejs to be {{CSSNonAnimatableProperties}}, I suppose.

@Gitoffthelawn
Copy link
Author

@wbamberg I am in receipt of your replies, thank you. I skimmed them quickly, but as I'm very busy right now, I will need to leave your replies in my queue for response when I can give them the thought and attention they deserve. In the event that my response is delayed for longer than meets your needs, feel free to ping me, and I'll adjust queue position accordingly. Thanks.

@Josh-Cena Josh-Cena added needs decision The task needs consensus through discussion and removed needs info Needs more information to review or act on. labels Jun 19, 2024
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 needs decision The task needs consensus through discussion
Projects
None yet
Development

No branches or pull requests

6 participants