material-components / material-components/material-components-android
[TopAppBar] Description of changing icon click color
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 17.4k
- Forks
- 3.2k
- PR merge metrics
- No merged PRs in 30d
Description
### Problem
While reading Material UI 3 official guide I noticed there is a _**Accessibility** > **Interaction and style**_ section with [icon click effect](https://m3.material.io/components/top-app-bar/accessibility#d5f83453-d780-4fe0-bdf6-997af74ba1d6) There is no any information how to override this color effect. Whereby I have to find out where could I change this property, because `Light` theme, as default, contains black effect and `Dark` theme contains white effect respectively.
It's a bit annoying, where You want set white background with black AppBar and white click effect, containing also light theme.
### Solution
There should be an information about setting ripple color using `Theme.Material3.*.NoActionBar`:
```
<!-- Ripple effect color -->
<item name="android:colorControlHighlight">#1FFFFFFF</item>
```
Eventually there should be an information about changing it by component level. I haven't found it yet in documentation, consider adding it as a separate section or customization.
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
Start with the Material 3 TopAppBar Accessibility > Interaction and style guidance and verify the provided Theme.Material3.Light.NoActionBar colorControlHighlight example. Document the theme-level ripple color and, if supported, the component-level customization; done when readers can change the icon click effect for both light and dark themes.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- android
- Domain
- documentation, mobile-dev
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 50/100