material-components / material-components/material-components-android
[Docs] unify scrim opacity
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 17.4k
- Forks
- 3.2k
- PR merge metrics
- No merged PRs in 30d
Description
**Description:** #3635
- https://m3.material.io/styles/elevation/applying-elevation:
```
Scrims use the scrim color role at an opacity of 32%.
```
- https://m3.material.io/components/navigation-drawer/specs:
```
Navigation drawers scrim color md.ref.palette.neutral-variant20
Navigation drawers scrim opacity 0.4
```
- https://github.com/material-components/material-components-android/blob/master/docs/components/NavigationDrawer.md:
```
Element | Attribute | Related method(s) | Default value
Color | N/A | setScrimColor on DrawerLayout | Black at 60% opacity
```
- https://m3.material.io/components/bottom-sheets/specs:
```
On Android platforms, the scrim color and opacity is automatically handled by the system UI.
```
**Expected behavior:**
- https://m3.material.io/styles/elevation/applying-elevation:
No change.
```
Scrims use the scrim color role at an opacity of 32%.
```
- https://m3.material.io/components/navigation-drawer/specs:
md.ref.palette.neutral-variant20 -> md.ref.palette.neutral-variant0 (BLACK)?
0.4 -> 0.32
```
Navigation drawers scrim color md.ref.palette.neutral-variant0
Navigation drawers scrim opacity 0.32
```
- https://github.com/material-components/material-components-android/blob/master/docs/components/NavigationDrawer.md:
60% -> 32%
```
Element | Attribute | Related method(s) | Default value
Color | N/A | setScrimColor on DrawerLayout | Black at 32% opacity
```
- https://m3.material.io/components/bottom-sheets/specs:
Remove or revise the description (at least, the scrim opacity can be changed (https://github.com/material-components/material-components-android/commit/f3e4439ca69f993baa6626ad6a82937c2d283155)).
```
On Android platforms, the scrim color and opacity is automatically handled by the system UI.
```
**See also:** https://issuetracker.google.com/issues/365245820
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Compare the referenced Material 3 elevation, navigation drawer, and bottom-sheet specifications with docs/components/NavigationDrawer.md. Start by checking the current scrim color and opacity wording in those documentation sources, then update the affected documentation so the stated values and bottom-sheet behavior are consistent; verify all referenced scrim descriptions afterward.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- android
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100