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

[TopAppBar] Description of changing icon click color

Open
#3,310 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature request Issue: Dev Doc Widget: TopAppBar
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

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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.