Releases: material-components/material-components-android
Releases · material-components/material-components-android
1.7.0-alpha02
Important
New minimum requirements for your app project:
- Update to Android Gradle Plugin (AGP) version 7.2.0
- Update to Gradle version 7.3.3
- Update to Java 8 (version 1.8)
- Update to Android Studio Chipmunk, version 2021.2.1
What's new
- New
MaterialSwitchcomponent! (Spec)
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.appcompat | 1.1.0 | 1.4.0 |
| androidx.core | 1.5.0 | 1.6.0 |
| androidx.test | 1.1.0 | 1.4.0 |
| Android Gradle Plugin (AGP) | 4.0.0 | 7.2.0 |
| Gradle | 6.1.1 | 7.3.3 |
| Java Version | 1.7 (7) | 1.8 (8) |
Library Updates
Switch- Create icon style for the new switch design (a3ca744)
- Added token generated resources. (6512092)
- Support tinting thumb & track according to thumb position (3b257c0)
- Add a workaround to get thumb position (72bac61)
- Override switch width set by AppCompat to respect the drawable width (fd40fea)
- Implement track decoration in the new design (1e7bd27)
- Add thumb and track drawables for the new switch design (1414f9e)
- Create a base skeleton of the new MaterialSwitch package/class (b2a3fbe)
ChipSnackbarMaterialButton- Updated M3 button style to add outlined icon button style. Updated catalog to showcase the same. (467a2c9)
- Updated M3 button style to add filled tonal icon button style. Updated catalog to showcase the same. (14578ed)
- Updated M3 button style to add filled icon button style. Updated catalog to showcase the same. (25606cf)
- Always update drawable state when background changed (363e2b1)
- Added materialIconButtonStyle attribute and updated M3 doc to document icon (only) button style and attribute. (402bdf4)
- Migrated shape appearance to new shape system. (1d3bb00)
- Fix the issue that button state is not updated (45b99f6)
Color- Added DynamicColorsTest. (66581f2)
- Fix Resources Loader bug for color harmonization (78d2c1f)
- Update Dynamic Colors condition (b3a7daf)
- Provide better logging for ColorResourcesTableCreator (29fddaa)
- Refactored ColorHarmonizationDemoFragment to DemoActivity (65e7506)
- Refactored PreferencesActivity to allow configurations on any activity-level preferences/options (dfd8dba)
- Added DynamicColorsTest. (a2507b8)
- Updated color harmonization demo (dc65df3)
- Fix resources being re-harmonized when wrapContextIfAvailable() is used. (f0f07c5)
- Added ColorGrid classes for color harmonization demo. (0347587)
- Add kyocera to dynamic colors allowlist and reorganized based on alphabetical order. (66990a1)
- Fix HarmonizedColorsOptions.Builder#setColorAttributes is marked as nullable (824a12b)
TopAppBar- Fix copy constructors (382ce9c)
- Add null check for logo ConstantState check (2ac796f)
- Loosen check for scrollable child when adding a11y actions (4b81bb1)
- Fix scrolling for a11y (72228f4)
- Fix collapsing title issue with different fonts (0c341c4)
- Fix margins not applied when collapsed and expanded text size and type face are the same (526ce8c)
- Add setLiftOnScrollTargetView() method (d6c4354)
TextInputLayout- Add a new custom length counter field and getters/setters to switch how text length is calculated for the counter. (4ded01e)
- Link OnItemSelectedListener of AutoCompleteTextView with the actual drop-down list (2db8b0c)
- Fix hint is not displayed when expanding space is limited (73cb1b6)
- Fix for TextInputLayout leak via AccessibilityManager. (673cefc)
- Centralize icon view state handling logic (ac74bc3)
- Move end icon and content description logic to the layout class (86b512a)
- Centralize accessibility event dispatching logic for drop-downs (d3ab6d7)
- Remove TextInputLayout.getEditText() calls from EndIconDelegates (7b2f924)
- Fix icon ripples go behind the edit text (2c0e42f)
- Move drop-down background and ripple creation to TextInputLayout class (1a42c74)
- Updated shape to use M3 attrs/styles. (0e4e44e)
- Create EndIconDelegate.deactivate() method and remove the relevant listener (a0e8c35)
A11yTimePickerBottomSheetDivider- Fixed extra space when lastItemDecorated = false (714521b)
SliderTransitions / Motion- Update container transform to use new motion system. (f2f454b)
MaterialCardView- Migrated shape appearance to new shape system. (bfce84a)
CollapsingToolbarLayout- Allow application to Set ellipsis to Title in CollapsingToolBar (7b043c3)
NavigationRail- Update active indicator to use new shape system. (f700e6d)
ProgressIndicator- Fix indeterminate progress indicator not working on API 22 (61cbb8c)
BottomNavigationViewExposedDropdownMenu- Added support for default/ripple background colors for the selected item of the exposed dropdown menu when the default MaterialAutoCompleteArrayAdapter is being used. (6206ff5)
MaterialDatePickerFloatingActionButtonBottomAppBarTokens- U...
Contributors
macro and android
Assets 3
1.6.0
What's new since 1.5.0
- Color harmonization support! Check out the following resources for more information:
- Designing Harmony into Dynamic Color blog post
- Using color harmonization documentation
Other highlights
Material 3- Hide shadows on all M3 Toolbar styles, not just Surface style (b49284e)
- Migrate action bar popup themes to M3 (2ae3ca4)
- Update M3 card elevation according to the spec (bb23e2d)
- Add missing attributes to M3 button styles (3c9b452)
- Update M3 navigation rail text appearances (6b57c52)
- Fix M3 date picker styles (fba1a34)
- Change checkedIconGravity values to enum (bc56d5b)
BadgingBottomNavigationViewBottomSheetChipCollapsingToolbarLayoutColor- Fix resources being re-harmonized when wrapContextIfAvailable() is used. (b402cb3)
- Added ColorGrid classes for color harmonization demo. (fcc1091)
- Add kyocera to dynamic colors allowlist and reorganized based on alphabetical order. (1dad5f6)
- Fix HarmonizedColorsOptions.Builder#setColorAttributes is marked as nullable (44054aa)
- Added support for color resources harmonization in XML (869d943)
- Refactor DynamicColors overloading methods and added DynamicColorsOptions class to support color harmonization. (bdbf052)
- Update DynamicColors to use peekDecorView() instead of getDecorView() when applying dynamic color theme overlay (56ed070)
- Update DynamicColors util to applyStyle() on window decorView theme as well to fix potential ContextMenu issue (f6c8fa5)
- Update DynamicColors util to use activity.getTheme().applyStyle() instead of activity.setTheme() to workaround Force Dark issue (b84f35f)
- Avoid Short#compare usage in ColorResourcesTableCreator.java since it requires API level 19 (48741b4)
- Add Resource Table format for XML color Harmonization. (822a5b2)
DialogDivider- Added attribute in MaterialDividerItemDecoration to remove item decoration from last recycler view item. (9416b2c)
MaterialDatePickerMaterialButtonMaterialCardViewMaterialShapeDrawable- Implement getAlpha() (5ff917d)
NavigationRail- Added support for opting in/out of the NavigationRail automatically adding system top and bottom window insets. (c66633b)
SliderSnackbar- Fixed margins are added multiple times when show() is called (2bfc7ba)
- Fixed the issue that setting margins programmatically does not work (d5856fd)
- Support setting max lines programmatically (4c7be52)
- Enforce vertical layout when action text is too long (ff97a68)
- Fixed NPE on Android 8 & 9 (35d9da8)
- Fixed maxWidth is not applied on Snackbar (6a3ea94)
TabsTextInputLayout- Fixed regression bug of prefix spacing being shown and making expanded label be in the wrong position when text field is not focused. (4d78879)
- Extracted start components from TextInputLayout (9a46af2)
- Split icon tinting logic to a helper class (9789f2e)
- Provided set simple items API with default item layout for MaterialAutoCompleteTextView (85ed993)
- Added support for minEms and maxEms (7d46b95)
- Applied edit text's letter spacing to expanded hints (88eb089)
- Text field should comply with system level bold (e8bde75)
- Fixed crashes when text field size is too large (cf5df22)
- Fixed getBoxCornerRadiusBottomEnd and getBoxCornerRadiusBottomStart returning wrong values. (9d2f864)
TopAppBar- Fixed app:expanded=false not working (2f3110f)
- Fixed centering logic when title and subtitle are the same (f69e3a0)
- Support scaleType and adjustViewBounds for logo (b01051b)
- Make title and subtitle match ActionBar's (0f2b537)
- Save and restore scroll state during scroll range recalculation (698cf9b)
- Fixed top app bar snapping issue (acb7958)
- Fixed expanded title margin not applied (89d80d0)
- Correctly set letter spacing when expanding titles (44d4c3e)
- Fixed text alignment of multi-line title in collapsing toolbar (e6db8a4)
- Fixed snap issue with transparent status bar (b935604)
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.fragment | 1.0.0 | 1.2.5 |
Full list of changes
Full list of release notes
Contributors
bytesparrow
Assets 3
1.6.0-rc01
Dependency Updates
- No dependency updates
Library Updates
A11yTextInputLayout- Fixed regression bug of prefix spacing being shown and making expanded label be in the wrong position when text field is not focused. (4d78879)
Material 3- Add additional condition to check dynamic color supported devices (51093e1)
MaterialDatePicker- Fix edge-to-edge mode being applied multiple times (e1ee959)
TopAppBar- Fix app:expanded=false not working (2f3110f)
Color- Fix HarmonizedColorsOptions.Builder#setColorAttributes is marked as nullable (44054aa)
Other
Full list of changes
1.7.0-alpha01
Dependency Updates
- No dependency updates
Library Updates
-
TextInputLayout- Centralize EndIconDelegate listener logic (26308d9)
- Fixed regression bug of prefix spacing being shown and making expanded label be in the wrong position when text field is not focused. (784f901)
- Create EndIconDelegates in an on-demand fashion (7c160c8)
- Extract end components from TextInputLayout (6cdf7b5)
-
ExposedDropdownMenu- Updated the elevation of the popup to match M3 specs. Also fixed bug where elevation wasn't being read via xml. (2c335b5)
- Removed update dropdown background call from setInputType as it indirectly calls setRawInputType (f915ffd)
- Update dropdown background when setRawInputType is called. (f31414a)
- Fixed android:popupBackground not working in xml/styles for the AutoCompleteTextView. (df3a708)
- Update background when setInputType is called so that ripple is or isn't present properly. (1c02b62)
-
DatePicker -
RadioButton- Documentation review (b7b0aa3)
-
Tabs- tab layout should not ignore focused state ripple color (5a0541f)
-
Slider- Make slider's height adjustable with track height or thumb radius (dc0d8a9)
-
Button -
TopAppBar- Fix app:expanded=false not working (05be1b9)
-
TextView- Deprecated 4 arg constructor. (df273cd)
-
NavigationRail- Fix bottom padding being applied to top bug (5173944)
-
Accessibility- Added more a11y tests for text fields and exposed dropdown menu. Also updated robolectric version (863d6aa)
- Make picker header focusable to improve TalkBack response (c23daec)
- Attach/detach badge contentDescription when using menuItem. (ee49c5a)
- Make label important for accessibility (0ba0d65)
- Fixed bug where setting the AutoCompleteTextView's input type to TYPE_NULL in code would make it unusable in a11y touch mode, as it was still seen as editable for a11y. (01021a7)
- Update accessibility className used for hour/minute Chips (a51d1dc)
- Fixed text field's focused rect wrong behavior when using a11y magnification. (dce4419)
-
Transitions / Motion -
Color -
Catalog -
Documentation -
Tokens- Upgraded to v0.87. (c5284c6)
-
Other
Full list of changes
1.6.0-beta01
Dependency Updates
- No dependency updates
Library Updates
Color- Deprecated previous apply...() APIs and add overload for activity apply method with no options (8363cde)
- Iterated on HarmonizedColors and DynamicColors feedback (b70bbc2)
- Updated dark tone values for ColorRoles. (7b51353)
- Updated getters/setters naming in the
HarmonizedColorsOptions(bfb6086) - Fixed formatting and typos for resources harmonization. (d24b3a9)
- Updated Color dev doc and added new section for Apply dynamic colors using
DynamicColorsOptionsand Resource Harmonization. (a81a658)
NavigationRailTextInputLayout- Added class documentation to use TextInputLayout's context to construct the child TextInputEditText. (1085583)
- Fixed end icon focus in a11y mode when a11y mode is turned on/off after views have been attached. Also added a11y tests. (b9a21f0)
- Fixed text field's focused rect wrong behavior when using a11y magnification. (a8d8e70)
Tokens- Upgraded to v0.79. (ccfc0ee)
- Migrated deprecated motion token generated resources. (91c2530)
- Removed deprecated font family resource. (6a4fa0b)
- Added missing palette token generated resources. (e7a691e)
- Added new shape appearance styles. (a5b78e6)
- Added lineHeight attr into TextAppearance. (b4d4450)
TimePicker- Updated accessibility className used for hour/minute Chips (981129f)
- Updated to give more context on hour/minute selection (380778f)
- Fixed TalkBack from announcing unavailable action (1b14715)
- Fixed TalkBack announcing wrong selection between hour/minute (47781d5)
- Fixed wrong clock item selection (9cdf4c9)
Tabs- Fixed tabs with padding in fixed mode from scrolling (9c2df28)
SliderDatePicker- Always go edge-to-edge in fullscreen mode (be6050a)
CatalogMaterial 3- Added additional condition to check dynamic color supported devices (69121c8)
NavigationView- Fixed navigation view item ripple (cfc307e)
TopAppBar- Fixed centering logic when title and subtitle are the same (f69e3a0)
Other- Updated bug report template with more instructions for minimal sample app (a147bca)
Full list of changes
1.6.0-alpha03
Dependency Updates
- No dependency updates
Library Updates
Color- Refactored DynamicColors overloading methods and added DynamicColorsOptions class to support color harmonization. (bdbf052)
- Updated DynamicColors util to applyStyle() on window decorView theme as well to fix potential ContextMenu issue (f6c8fa5)
- Updated DynamicColors util to use activity.getTheme().applyStyle() instead of activity.setTheme() to workaround Force Dark issue (b84f35f)
- Added missing M3 color attributes to public (0c8fc41)
- Add support for color resources harmonization in XML (869d943)
TextInputLayout- Provide set simple items API with default item layout for MaterialAutoCompleteTextView (85ed993)
- Updated documentation to clarify end icon mode's expected usage and behaviors relating to the icon's drawable. (1b7e92d)
- Fixed icons behaving unexpectedly when switching modes + bug of wrong icon tint state when setting an icon programmatically. (ae16efd)
- Added line mask expansion animation to filled box underline. (2463946)
- Added support for minEms and maxEms (7d46b95)
MaterialButtonToggleGroup- Removed getAccessibilityClassName() override since TalkBack doesn't recognize the class name, in favor of getting identified as a generic list container (96fa85e)
CatalogDialog- Fixed crashes when colorControlHighlight is a CSL (1c5c054)
NavigationRailTokensSnackbarBadging- Prevent multiple badges being attached to a menu item at the same time (b3db1cc)
CollapsingToolbarLayoutA11y- Fixed prefix/suffix not being properly announced when the text field is focused and they show up. Improved their screen reader focus order to align with the visual order of the elements: navigating to the left will focus on the prefix and navigating to the right will focus on the suffix. (b690127)
- Fixed Switch Access not being able to reach clock items (f9914da)
TopAppBarMaterialCardView- Fixed crash on Pre-Q devices when checked icon is null (b4cab87)
BottomNavigationViewBottomSheetMaterialDatePicker- Start align edit icon in landscape (94cd532)
Chip- Refactored chip group selection logic to a standalone class (f3c6430)
MaterialButton- Fixed icon position not being updated when size is not changed (b0f3700)
TimePicker- Added setters for hour and minute (85a4405)
Toolbar- Hide shadows on all M3 Toolbar styles, not just Surface style (b49284e)
Slider- Added support for custom thumb drawables (17da000)
Typography
Full list of changes
1.6.0-alpha02
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.fragment | 1.0.0 | 1.2.5 |
Library Updates
Material 3TextInputLayoutMaterialDatePickerDialogBadgingTopAppBarSnackbarA11yColor- Avoid Short#compare usage in ColorResourcesTableCreator.java since it requires API level 19 (48741b4)
- Set android:windowBackground to android:colorBackground (dac9bf3)
- Add additional condition to check dynamic color supported devices (833f410)
- Add Resource Table format for XML color Harmonization. (822a5b2)
Divider- Added attribute in MaterialDividerItemDecoration to remove item decoration from last recycler view item. (9416b2c)
TabsMaterialButton- Support icon gravity with text alignments other than centered (6c41f07)
Slider- Fix lint error caused by hidden super interface (3cf0647)
Tokens- Upgrade M3 token resources to v0.71 (4de8565)
Documentation- Update library version in Getting Started doc to 1.5.0 (e98cee5)
Catalog- Fix chip icon colors (5fac4fd)
Other- Update library version to 1.6.0-alpha02 (80e50de)
- Replace all jcenter with mavenCentral (ad97f01)
- Horizontally center the checkbox button drawable if there is no text (8f4837e)
- Fix drawables not applying system level bold (90787bf)
- Simplify MaterialButtonToggleGroup's checking logic (3db25be)
- Remove paddingTopSystemWindowInsets from flags checked to apply windowInsetListener (2e73d1a)
Full list of changes
1.5.0
What's new since 1.4.0
Material3themes, styles, and functionality! Check out the following resources for more information:- Material 3 site and guidelines
- Start building with Material You blog post
- Migrating to Material Design 3 blog post
- Getting started & dynamic color developer documentation
- New
Dividercomponent (Docs)
Other highlights
Badging- Added support for differing offsets for badges with/without text, and support for badge width and padding in styles. (bd4914d)
BottomAppBarBottomNavigationView- Updated to explicitly read and set minimum height. (943c4f0)
BottomSheet- Added maxHeight to bottom sheet behavior (a38d2d8)
Chip- Fixed icon tint states are not updated after setting new icon (c08a07d)
CollapsingToolbarLayout- Added option to add extra height when title text spans across multiple lines (655dde0)
- Added option to force always applying system window inset top regardless of layout_height (9ebf1a1)
- Fixed multiline RTL collapsed title text position (af35dfb)
- Added support for expanded and collapsed title text color attributes (5c14772)
- Fixed RTL text only laying out as RTL when actual text is RTL (841f229)
- Added title line spacing and hyphenation frequency setters (f0ce498)
- Added support for multiline RTL when using fade title mode (f0ac362)
- Updated default multiline hyphenation frequency to StaticLayout.HYPHENATION_FREQUENCY_NORMAL (3ad232d)
MaterialButtonMaterialDatePickerSnackbarTextInputLayoutTimePicker
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| compileSdkVersion | 30 | 31 |
| targetSdkVersion | 29 | 31 |
| androidx.annotation | 1.0.1 | 1.2.0 |
| androidx.drawerlayout | N/A | 1.1.1 |
Full list of changes
Full list of release notes
1.5.0-rc01
Dependency Updates
- No dependency updates
Library Updates
Material 3- Add supporting brand list of dynamic colors (66b1c0e)
- Update M3 card elevation according to the spec (91f1f2e)
- Add missing attributes to M3 button styles (55a67a6)
- Update Button elevation to match specs (835624e)
- Update Button padding to match specs (0ac68ec)
- Update M3 navigation rail text appearances (db5b3d4)
- Do not enforce text appearance with Tab M3 styles (7975920)
- Fix M3 date picker styles (1579272)
Chip- Add missing attributes to M3 chip styles (d95ad41)
DialogBottomNavigationViewSnackbar- Fix maxWidth is not applied on Snackbar (15e2254)
Color- Add additional condition to check dynamic color supported devices (817dc12)
Other- Update library release version to 1.5.0-rc01 (f14d1a2)
Full list of changes
Contributors
bytesparrow
Assets 3
1.6.0-alpha01
Dependency Updates
- No dependency updates
Library Updates
Material 3- Update M3 card elevation according to the spec (bb23e2d)
- Add missing attributes to M3 button styles (3c9b452)
- Update elevation to match specs (db64adb)
- Update padding to match specs (f028380)
- Update M3 navigation rail text appearances (6b57c52)
- Do not enforce text appearance with M3 styles (04a6b6c)
- Fix M3 date picker styles (fba1a34)
- Change checkedIconGravity values to enum (bc56d5b)
- Add supporting manufacturer list of dynamic colors (e5023f6)
- Add textAppearanceListItem* styles to theme (bed2ac1)
A11y- Improved accessibility for switch access. (2d337c5)
- collapsing toolbar layout not respecting system level bold (65754bd)
- accessibilityManager.isEnabled() is not reliable to check if component is in a11y mode, as it may return true unexpectedly. (b878fc3)
- Fix Talkback doesn't announce minutes selection (c07e5f2)
- Make Talkback announce action on clock items (38406e1)
- Fixed dropdown list not showing for non editable dropdown menus in switch access mode. (d8e19dd)
- Fixed RTL support for setting corner radius on TextInputLayout. (dca7fc0)
- Fix system level bold not applied (c6be59c)
- Removed TextInputLayout's placeholder text duplicated announcement. (20c3ad0)
Documentation- Added note about screen readers skipping decorative text field elements. (a369449)
- Add migration codelab and M2 -> M3 theme mapping to Getting Started doc (05a74bd)
- Removed broken links from divider doc. (3b6c804)
- Reformatted color.md. (735b88e)
- Update Getting Started doc to link to Material Theme Builder (255cc17)
- Small typo fix in checkbox doc (2b441e6)
TextInputLayout- Remove unneeded logic (1d50ed7)
- Fix crashes when text field size is too large (cf5df22)
- Correctly calculate hint text offset (34cce18)
- Fixed calculateLabelMarginTop() value for filled text field style, which caused getBaseline() to return a wrong offset. (c7c5c7c)
- Fix helper text label for usage (aaac96d)
- Fixed getBoxCornerRadiusBottomEnd and getBoxCornerRadiusBottomStart returning wrong values. (9d2f864)
- Fixed shouldAnimateCaptionView() returning true when captionText is null. (c352dfd)
- Don't add placeholder view to text field's input frame if placeholder is null. (3ca3b71)
ColorCatalogTopAppBarMaterialDatePickerChipMaterialCardViewTabs- Fix NPE caused by set a position less than 0 (823c34a)
Dialog- Enforce material theme in M3 dialog styles (728a1e6)
BottomNavigationViewMaterialShapeDrawable- Implement getAlpha() (5ff917d)
Other- update library version to 1.6.0-alpha01 (53ddac4)
- Internal change (a487c89)
- Internal change (9d86d27)
- Add margin flags to BottomSheetBehavior for system inset bars. (185a0f9)
- Automated g4 rollback of changelist 409212345 (d5729d5)
- Removed extra space between the list view container and the navigation bar. (6517aa6)
- Add margin flags to BottomSheetBehavior for system inset bars. (022a05f)
- Small clean-up of CollapsingTextHelper (c80177d)
- Internal change. (33f1e3b)
- Remove IllegalArgumentException in settleToState (dbd37d2)
Full list of changes
Contributors
bytesparrow