material-components / material-components/material-components-android

[Docs] unify scrim opacity

Open
#4,295 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug Feature: Color
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.