Skip to content

Conversation

mapache-salvaje
Copy link
Contributor

@mapache-salvaje mapache-salvaje commented Jul 30, 2025

part of the ongoing auditing project, currently tackling the Charts docs alphabetically (DX-15)

@mapache-salvaje mapache-salvaje added docs Improvements or additions to the documentation. scope: charts Changes related to the charts. type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature. labels Jul 30, 2025
@mui-bot
Copy link

mui-bot commented Jul 30, 2025

Deploy preview: https://deploy-preview-18990--material-ui-x.netlify.app/

Updated pages:

Bundle size report

Bundle Parsed Size Gzip Size
@mui/x-data-grid 0B(0.00%) 0B(0.00%)
@mui/x-data-grid/DataGrid 0B(0.00%) 0B(0.00%)
@mui/x-data-grid-pro 0B(0.00%) 0B(0.00%)
@mui/x-data-grid-pro/DataGridPro 0B(0.00%) 0B(0.00%)
@mui/x-data-grid-premium 0B(0.00%) 0B(0.00%)
@mui/x-data-grid-premium/DataGridPremium 0B(0.00%) 0B(0.00%)
@mui/x-charts 0B(0.00%) 0B(0.00%)
@mui/x-charts-pro 0B(0.00%) 0B(0.00%)
@mui/x-date-pickers 0B(0.00%) 0B(0.00%)
@mui/x-date-pickers-pro 0B(0.00%) 0B(0.00%)
@mui/x-tree-view 0B(0.00%) 0B(0.00%)
@mui/x-tree-view-pro 0B(0.00%) 0B(0.00%)

Details of bundle changes

Generated by 🚫 dangerJS against 1307f46

@@ -5,53 +5,68 @@ productId: x-charts

# Charts - Animation
Copy link
Contributor Author

Choose a reason for hiding this comment

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

TIL that this h1 is necessary even though we have title defined in the frontmatter above. Isn't that redundant?

Copy link
Member

Choose a reason for hiding this comment

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

Probably yeah, I think the frontmatter one is used for the page title only? Not sure 🤔

Copy link
Contributor Author

@mapache-salvaje mapache-salvaje Aug 4, 2025

Choose a reason for hiding this comment

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

It used to be the case that the # was only necessary if you wanted the page's h1 to be different from the title (for SEO purposes, for instance, to add the Pro/Premium icons). Not sure when or why this changed.

Copy link

codspeed-hq bot commented Jul 30, 2025

CodSpeed Performance Report

Merging #18990 will not alter performance

Comparing mapache-salvaje:charts-animation (1307f46) with master (d9f860d)1

Summary

✅ 10 untouched benchmarks

Footnotes

  1. No successful run was found on master (d249541) during the generation of this report, so d9f860d was used instead as the comparison base. There might be some changes unrelated to this pull request in this report.

@mapache-salvaje mapache-salvaje changed the title [charts][docs] Revise the Charts Animation doc [charts][docs] Revise the Charts Animation doc (DX-15) Jul 30, 2025
@mapache-salvaje mapache-salvaje changed the title [charts][docs] Revise the Charts Animation doc (DX-15) [charts][docs] Revise the Charts Animation doc (DX-36) Jul 30, 2025
@JCQuintas
Copy link
Member

I've noticed this PR and remembered we had a task to add motion as one of the examples. I've create a separate PR for it here: #18993

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Jul 31, 2025
Copy link

This pull request has conflicts, please resolve those before we can evaluate the pull request.

Signed-off-by: mapache-salvaje <71297412+mapache-salvaje@users.noreply.github.com>
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 4, 2025
Comment on lines +19 to +20
You can override the default CSS classes to customize CSS-based animations.
The demo below shows how to do this by adding an animated color gradient to the label text:
Copy link
Member

Choose a reason for hiding this comment

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

This animation example is weird. It only shows how to add a new animation to an element, rather than updating one of our animations.

@bernardobelchior WDYT about replacing it with something like, changing the timing of the slice animation?

Copy link
Member

@bernardobelchior bernardobelchior Aug 4, 2025

Choose a reason for hiding this comment

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

This is replacing the default animation of the pie arc label with a custom one. Isn't that what you mean by "updating the animation"?

Copy link
Member

Choose a reason for hiding this comment

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

Ah true, though the animation itself is a bit odd, as it doesn't serve a clear purpose. 🤔

Copy link
Member

Choose a reason for hiding this comment

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

Any suggestion? I'm open to improving it!

Copy link
Member

Choose a reason for hiding this comment

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

I was thinking something that slightly changes the current animations, rather than completely replace it.

Maybe just add a delay to the animation start and make the animation longer overall? The original opacity animation I mean.

Copy link
Member

Choose a reason for hiding this comment

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

It can be done as a next step though, not necessary to be in this PR

Copy link
Member

Choose a reason for hiding this comment

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

Sounds good. Stored it in my todo

Copy link
Member

Choose a reason for hiding this comment

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

Something like this?


### Using React Spring
## Third-party animation libraries
Copy link
Member

Choose a reason for hiding this comment

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

Is the third-party required here? I suppose if we say Animation libraries is is implied that they are not ours 🤔

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I wouldn't say required, but it is possible that MUI could have its own animation lib(s) so I think it's worth stating explicitly. We usually try to call out "third-party" resources to make it clear that they're beyond our control, if nothing else.

mapache-salvaje and others added 2 commits August 5, 2025 08:12
Co-authored-by: Alexandre Fauquette <45398769+alexfauquette@users.noreply.github.com>
Signed-off-by: mapache-salvaje <71297412+mapache-salvaje@users.noreply.github.com>
@mapache-salvaje mapache-salvaje merged commit c21455f into mui:master Aug 6, 2025
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation. scope: charts Changes related to the charts. type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants