materialdoc/materialdoc-web

Misleading pickers doc - DatePickerDialog and TimePickerDialog doesn't implement material design on pre-Lollipop devices

gregkorossy opened this issue · 3 comments

The docs are a bit misleading about the look-and-feel of the pickers because the appcompat lib implies that they will have the material treatment on all compatible platforms, but this is not the case.

This is what it looks like on API 15 using android.app.*:

DatePickerDialog TimePickerDialog
screenshot_1504549444 screenshot_1504550043

And this is how it should (this is the (8.0 - Oreo) framework (not the "opt") version backported to API 14+; I made it because I didn't like the old look and wanted to provide material on all compatible API levels):

DatePickerDialog TimePickerDialog
screenshot_1504549535 screenshot_1504549946

Maybe a little warning would be "nice", so people wouldn't expect them to have the material design on pre-L devices?

Hi,

Thanks for your reply. We are still deciding about what min API we should target to provide documentation.

In my opinion it's time to move to v21, most of new projects will start with minSDK 21. It would be easier to keep documentation up to date.

I'm not sure the Android ecosystem is ready for minSdk 21 yet (I wish it was). Even Google devs don't think so as they've backported the fragment transitions (shared elements) to API 14+ (should've been part of support lib 26.0.0, but they haven't released it yet for whatever reasons; see this discussion, especially the latest comments). Also, if you take a look at the dashboard, you'll see that API 15-19 represent a whopping 24.3% of the devices that visited the Play Store during that given period, which is, in my opinion, still a significant amount.

Of course it would be nice if we could just use minSdk 21, but I think we're not there yet. Nonetheless, these awesome collections of docs and guides can support API 21+ only, but it should clearly state so people would know before implementing some not-everywhere-material stuff only to find out from dissatisfied users.

@Gericop I agree. We will figure out if we will support <21 or >=21 and put some note on home page, thanks.

Before that happens ticket will be open.