search

mui / mui-x

MUI X: Build complex and data-rich applications using a growing list of advanced React components, like the Data Grid, Date and Time Pickers, Charts, and more!
https://mui.com/x/
4.51k stars 1.31k forks source link

[charts] Composition demos/ejection #12430

Open oliviertassinari opened 7 months ago

oliviertassinari commented 7 months ago

Summary

Inspired by:

it feels like it would be great to focus on the DX to move from the wrapped/simple mode to the composed mode.

Examples

In practice, maybe it would a demo like it's done for the TextField https://mui.com/material-ui/react-text-field/#components.

Or maybe a separate docs page for each component type:

SCR-20240312-oytm

Motivation

Customizability, it's one of the biggest strengths of Recharts, why it's growing.

It's also part of why there is a purpose for MUI to focus on charts. Why we are working on this (there is value in having a React-only focus take + there is value in having a sustainable model to push recharts forward + highcharts should have an open-core model, it's crazy they don't).

Search keywords: -

ttante commented 7 months ago

Bumping this. From the docs online I can't understand how anyone could be expected to use Composition mode.

For example, all the tooltip components listed in the Composition section lack definitions & descriptions on their respective pages and no use example or demo that I can find.

The docs seem to be aimed at existing veterans & experts with x-charts. Most prop descriptions are also very meta and lack an example for clarification.