website icon indicating copy to clipboard operation
website copied to clipboard
verified publisher icon flutter

Add missing M2 widgets back to the new Material Components widgets catalog

Open InMatrix opened this issue 2 years ago • 5 comments

Page URL

https://docs.flutter.dev/development/ui/widgets/material/

Page source

https://github.com/flutter/website/tree/main/src/development/ui/widgets/material.md

Describe the problem

The newly updated Material Components widgets catalog (https://github.com/flutter/website/pull/8574) might have dropped a few widgets in the material library that were introduced by pervious Material versions. One example is the DataTable widget. This widget is still part of the material library and there's no plan to deprecate or replace it. Dropping the widget from the catalog is likely to make it harder to discover. In fact, the current Material widgets catalog is the second highest referrer to the DataTable widget's API doc: image

Expected fix

I propose the following steps to address the issue:

  • [ ] Compare M2 and M3 on material.io and identify components M2 introduced but M3 didn't cover
  • [ ] Identify related Flutter widgets
  • [ ] Select or create widget preview images which fit the style of existing ones
  • [ ] Add those widgets to the new Material widgets catalog page in an "Additional components from M2" section

Additional context

Cc: @guidezpl, @esouthren, @HansMuller, @nancyhu2023, @atsansone

InMatrix avatar Apr 24 '23 16:04 InMatrix

Can I work on this?

ArslanYM avatar May 04 '23 03:05 ArslanYM

@ArslanYM Thank you for your interest in helping out. I suggest we wait until the updated Material Components widget catalog is available to the public next week at Google I/O. The main challenge of adding additional widgets to the catalog is to select/create widget preview images that fit the style of existing ones. You can better assess whether this is something you'd like to help once you can see the new images in the catalog.

InMatrix avatar May 05 '23 18:05 InMatrix

@ArslanYM, yes, you can definitely work on this!

sfshaza2 avatar May 25 '23 15:05 sfshaza2

@sfshaza2 Thankyou, I will get started.

ArslanYM avatar May 25 '23 15:05 ArslanYM

For those widgets/components that have dropped out of spec, I'd recommend just mentioning them with links to documentation in the sentence "You can still check out our legacy Material 2 widgets over at their catalog page." These are the ones I could identify:

  • DataTable and variants
  • ~ExpansionPanel~ could be considered part of M3 lists flutter/flutter/issues/127252
  • Stepper

guidezpl avatar Mar 07 '24 08:03 guidezpl