Releases: material-components/material-components-android
Releases · material-components/material-components-android
1.11.0-alpha03
Important
Elevation Overlays within default component styles have been replaced by the new Tonal Surface Color system. Instead of blending the Primary color with the Surface color based on an elevation value, components will now use a specific Surface color role which can be more easily understood and customized.
Documentation for the affected components and which Surface color roles they use has been updated in 2114a11.
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.activity | 1.8.0-alpha06 | 1.8.0-beta01 |
Library Updates
BottomSheet- Fix sheet corners animation (de27132)
Carousel- Tweak uncontained strategy logic to adjust medium size items to improve motion (93660d4)
- Fixed formatted for KeylineState and KeylineStateList (b80d9a5)
- Fixed keyline shifting in RTL for uncontained carousels (7151714)
- Reduce the number of truncations in intermediate calculations (4ce7e4c)
- Update vertical scroll speed to be faster (c6ea2d4)
- Fix some a11y bugs in Carousel (3d84841)
- Center aligned uncontained carousel (b6f6eb5)
- Add left-aligned uncontained strategy (9d81cac)
- Fix orientation not correct in item decoration calculations (966f7da)
- Update mask size on size change if mask x percentage has been set (dc91b39)
Catalog- Update side sheet state handling to be more accurate in demos (357cf2d)
- Update bottom sheet state handling to be more accurate in demos (f9102c7)
- Fixed demos in RTL (4e1b130)
- Make side sheet demo icon easier to see in dark mode (79a1953)
- Remove explicit Catalog dependency on androidx.activity now that library depends on it (3bb69f5)
- buid.gradle update. (4847799)
- Remove edge-to-edge to top app bar demos due to glitches in ActionBar demo (c40e468)
- Update slider position when carousel is scrolled in uncontained carousel demo (480bbc6)
- Applied edge-to-edge to top app bar demos (aa5b5bc)
- Add uncontained carousel demo to catalog (ef9f918)
- Update slider position when carousel is scrolled in catalog demos (3652fde)
CollapsingToolbarLayout- Fixed title collapse fade mode color to use a Tonal Surface role instead of elevation overlay (5f2b4b2)
ColorDocumentation- Add uncontained variant docs (9ee4aba)
- Minor code block improvements (d7e75bb)
- Add guidance in fullscreen strategy docs about portrait orientation (caec8d2)
- Update chip documentation to use
setOnCheckedStateChangeListenerinstead ofsetOnCheckedChangeListenerwhich was deprecated in favour of the former (0582b1a) - Update example in docs to use
colorContainerandcolorOnContainerinstead ofcolorPrimaryandcolorOnPrimary. (44bfe2d) - Updated Color dev doc with tonal surface colors. (9a4c21d)
- Updated dev doc for tonal surface colors in affected components. (2114a11)
Material 3MaterialDatePickerNavigationView- Set material drawable background if the background has been set as a ColorStateList (eba40e9)
Predictive Back- Fix issue where modal accessibility is not reset after collapsing search view predictively, which caused the screen to appear frozen when using TalkBack (8d83a31)
Switch- Fix drawable scaling for API < 23 (a10c508)
Tabs- Integrated divider token output into the background drawables. (6b627c2)
TextInputLayout- Mutate cursor drawable before tinting it. (9a4888f)
TopAppBar- Simplified logics to animate the container color between lifted state and the default state. (1e9f5f0)
- Fix dynamic status bar foreground lift on scroll color when using Tonal Surface Color on API Level 33 (c4ae01a)
- Fix dynamic status bar foreground lift on scroll color when using Tonal Surface Color (569ddac)
- Fixed that liftOnScrollColor doesn't respect to setLifted when liftOnScroll is set to false. (43242f2)
- Added liftOnScroll and lifted toggles to the catalog. (4e995d1)
Other
Full list of changes
1.10.0-beta01
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto34
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.activity | 1.8.0-alpha06 | 1.8.0-beta01 |
Library Updates
Color- Remove resources loader support for tonal surface update (dfd9bfb)
BottomSheet- Fix sheet corners animation (a5ff190)
Full list of changes
1.10.0-alpha06
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto34
Dependency Updates
- No dependency updates.
Library Updates
Predictive BackMaterialSwitch- Amendments to thumb icon size support (3abb658)
Search- Enforced outline variant to use colorSurface as container color. (cbbd50d)
Full list of changes
1.11.0-alpha02
Important
Elevation Overlays within default component styles have been replaced by the new Tonal Surface Color system. Instead of blending the Primary color with the Surface color based on an elevation value, components will now use a specific Surface color role which can be more easily understood and customized.
Documentation for the affected components and which Surface color roles they use has been updated in 2114a11.
Dependency Updates
- No dependency updates.
Library Updates
BottomNavigationView- Set badges to be null instead of removing them from the sparse array so that removing badges before restoring badge states will not override the current state (9f2e686)
Carousel- Fix issue with next carousel item not being masked properly (a16f180)
- Add a layout listener to recyclerview to refresh keyline state upon size change (ff52862)
- Add carousel alignment attribute (547156e)
- Fix issue with not refreshing keylines (674ec44)
- Fix MaskableFrameLayout not updating mask after size change when setting the mask using setMaskXPercentage. (14023d2)
- Adding docs for fullscreen carousel strategy (7c40359)
CatalogChip- Fix a typo in attributes table in documentation (7289aa6)
Divider- Add RTL support (6b897c6)
DocumentationColor- Token upgrade to v0.170 for tonal surface colors. (8204856)
- Update dev docs for tonal surface colors in affected components. (2114a11)
- Add default framework text colors (d3dda60)
- Update contrast documentation (1d3b8e1)
- Add shift to dynamic colors allowlist (fde37cf)
- Expose attr contrastColorThemeOverlay (839b14c)
- Update constructor comments (ba465a2)
Predictive BackProgressIndicator- Allows extending LinearProgressIndicator and CircularProgressIndicator (3b0fd58)
SearchSideSheetSwitch- Amendments to thumb icon size support (db9a641)
Theming- Fix swapped error colors for dynamic contrast theme in light mode (f2ccc11)
TopAppBarSnackbar- Consistently use window coordinates to calculate Snackbar offsets. In one place screen and window coordinates are mixed, which leads to bad behavior in split screen apps. (57b2663)
Other
Full list of changes
1.11.0-alpha01
1.10.0-alpha05
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto34
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| androidx.activity | 1.8.0-alpha05 | 1.8.0-alpha06 |
Library Updates
A11y- Do not count headers for accessibility (917da52)
BadgingCarousel- Added orientation helper to clean up CarouselLayoutManager orientation differences (7822ef8)
- Updated docs to include hero variant (ec509cc)
- Added vertical scrolling capability (6b48d3b)
- Deprecated set/get mask x percentages in Maskable as they are no longer used anywhere, and is a misleading method due to these methods not actually having any effect on the Carousel as CarouselLayoutManager overrides the values. (29d8742)
Predictive Back- Fixed custom predictive back implementations and update
androidx.activitydependency to1.8.0-alpha06. (722b936) - Fixed MaterialBackAnimationHelper.onCancelBackProgress being called twice. (ad60bbf)
- Fixed possible NaN crashes in MaterialBottomContainerBackHelper, MaterialMainContainerBackHelper and MaterialSideContainerBackHelper. (122c296)
- Fixed custom predictive back implementations and update
Text Field- TextInputEditText misses some visible lines in CursorAnchorInfo#getVisibleLineBounds after scrolled (bdef355)
Full list of changes
1.10.0-alpha04
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto34
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| compileSdkVersion | android-UpsideDownCake | 34 |
| androidx.activity | - | 1.8.0-alpha05 |
| androidx.resourceInspectionAnnotation | - | 1.0.1 |
| androidx.resourceInspectionProcessor | - | 1.0.1 |
| org.jetbrains.kotlin:kotlin-bom | - | 1.8.22 |
Library Updates
BottomSheet- Updated bottom sheet documentation (af1fa70)
Carousel- Ensure that masks are pushed out beyond the parent bounds if they are on the parent bounds (9486de5)
- Carousel updates and fixes (16c1575)
- Fixed contained mask logic to only update masks when it is still in view, and remove restrictions on mask size with childWidth/2F. The only restriction is that the right of the mask must be greater than the left of the mask. (7d6a977)
- Fixed multi browse strategy clipping extra small items before being fully collapsed (85b6d50)
- Added Carousel Hero strategy demo (b57dae5)
- Added Hero carousel strategy (340cd44)
Dialog- Updated DialogWhenLarge theme to have correct parent theme (dae89b7)
Documentation- Revised version guidance for Search usage. (0bcb570)
Material 3MaterialButton- Set up Android Studio resource inspection annotation and annotation processor, and add @Attribute annotation to MaterialButton#getIconPadding (2b5c75f)
MaterialDatePicker- Allow client app to access user selected inputMode (4d80434)
NavigationRail,BottomNavigationView,NavigationView- Add itemTextAppearanceActiveBoldEnabled attr (022e217)
NavigationRail- Added bigger padding in between items on the navigation rail when font scale is large so there is more room for the badges when they are forced inside the view bounds (8b016a0)
Predictive BackSideSheet- Fixed SideSheetDialog documentation class definition and source links (e4d0fd3)
- Aligned close affordance and title text along the baseline rather than the top. (7a3f30b)
- Mapped close affordance to ?attr/colorOnSurfaceVariant in catalog. (7ee0b72)
- Added links to class definitions in Side Sheet documentation and revised version guidance. (d005ad7)
- Changed side sheet child containers in Catalog from LinearLayouts to FrameLayouts. (690cd5d)
- Changed side sheet title text appearance to Title Large. (a0d4fa0)
TimePicker- Fixed crash when clicking OK/Cancel/Icon on text input mode due to hiding keyboard (1fcde2c)
Other- Updated to compileSdkVersion 34 and update catalog to use androidx.activity:activity:1.8.0-alpha05 (2336c23)
- Fix kotlin version alignment (fc6f0a2)
- Update library version to 1.10.0-alpha04 (9123e4f)
- Replaced BuildCompat#isAtLeastU() method calls with explicit SDK checks for UPSIDE_DOWN_CAKE. (f2e70d2)
Full list of changes
Contributors
Attribute
Assets 3
1.10.0-alpha03
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto"android-UpsideDownCake"
Dependency Updates
| Dependency | Previous version | New version |
|---|---|---|
| appCompat | 1.5.0 | 1.6.1 |
Library Updates
ExposedDropdownMenu- Added attribute to set dropdown menu's container. (1562d0b)
ColorCarouselCatalogMaterialDatePicker- Fix crash when clicking OK/Cancel on text input mode due to hiding keyboard (7ccf670)
Documentation- Adds Search class definition link to Search documentation. (e157608)
Search- Fix expand/collapse animation for non-predictive back cases where rootView bounds are not equal to searchView bounds (577d23e)
SideSheetOther- Update library version to 1.10.0-alpha03 (11b8da4)
Full list of changes
1.9.0
What's new since 1.8.0
- Brand new Carousel component! Check out the Carousel design guidance and developer documentation for more details.
- Updated and improved Badge component! Check out the Badge design guidance and developer documentation for more details.
Dependency Updates
- No dependency updates.
Library Updates
BadgeBottomSheet- Added animation for bottom sheet position when keyboard is shown using WindowInsetsAnimationCompat API (697d93a)
CarouselColorSideSheetSliderTokens- Introduced new accent color tokens. (dac9450)
Full list of changes
Full list of release notes
1.10.0-alpha02
Important
New minimum requirements for your app's project:
- Update
compileSdkVersionto"android-UpsideDownCake"
Dependency Updates
None
Library Updates
-
Predictive Back- Add ability to opt-out of back handling in SearchView 176ce5e
- Make back helpers support generified View type 69b5386
- Only use device corner radius if SearchView reaches edge of screen a93c91a
- Update side container back helper to support containers with arbitrary child views 9405121
- Added predictive back support for standard 562285e and modal f335a50 side sheets
- Fixed subtle detached side sheet glitch where after predictive back the sheet did not fully slide off screen 52f1737
- Added handleBackInvoked() predictive back support for coplanar side sheets. b984e64
- Added updateBackProgress() predictive back support for coplanar side sheets 5ba704a
-
Badge- Added getters/setters for vertical and horizontal badge padding a0d0b53
- Added attribute to automatically adjust badge so that it is within the anchor view's grandparent view's bounds b706506
- Cleanup/fixes 4d50aa4
- Fixed crash caused by non-ascii strings 532b65d
- Fixed table formatting and remove unnecessary badge invalidation 44a97f4
-
Bottom sheet -
Carousel -
Color -
Dialog- Made dialog background color configurable in XML styles 77cdc1e
-
MaterialDatePicker- Updated screen width at which days size is 48dp in portrait mode ec511a5
- Fixed time zone when custom text input format is set 619d5a6
- Fixed ContentDescription for "DayName" not properly getting read by talkback for the German language 35bd1fc
- A11y/i18n alignment f4d0f56
- Added getTextColor to DayViewDecorator 29b59c2
-
Navigation View- Updated NavigationView to use ViewOutlineProvider to handle corner clipping when possible and remove drawerLayoutCornerClippingEnabled attribute c031144
-
Search- Made SearchBar and SearchView's container colors configurable in XML style cf006c5
- Improve performance by preventing item change notifications during inflation 203d5ec
- Updated search styles to set the default style attributes in the related theme overlay 9ffaa8d
- Support stylus handwriting in SearchBar 884a454
- Fix Search view prefix style e56e9b1
- Updated SearchDemoUtils to mark the class and methods as public so that it can be resued 3b43d41
-
SideSheet -
Switch- Added support for setting thumb icon size 2e85f06
-
Tokens- Upgraded outdated token output in textfield & appbar d722a78
- Integrated tokens and add shape appearance support in bottom navigation view 7bd9724
- Integrated tokens in bottom sheets 86cd9d7
- Integrated tokens and add shapeAppearance attribute in navigation rail 3b2b827
- Integrate container color token in Snackbar 206928b
-
Text fields- Added API to set cursor colors for API 28+ c598ccd
-
Top App Bar