From 4bef01b77e93ee40cd2690b51c4f2cdd3016addc Mon Sep 17 00:00:00 2001 From: Laxminarayan Chandrashekar <5959880+lxminarayn@users.noreply.github.com> Date: Thu, 22 Oct 2026 09:42:52 +0530 Subject: [PATCH] docs(material/tabs): clarify when background and foreground tokens apply Notes that the `background-color` and `foreground-color` tokens only take effect when the `backgroundColor` input is set, which is supported in M2 themes only, and points to the tokens that customize the label and indicator colors in M3 themes. Fixes #30186. --- src/material/tabs/tabs.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/material/tabs/tabs.md b/src/material/tabs/tabs.md index d48905c52598..d25279ae1cee 100644 --- a/src/material/tabs/tabs.md +++ b/src/material/tabs/tabs.md @@ -100,6 +100,14 @@ The `mat-tab-group` component can be integrated with the `@angular/cdk/drag-drop +### Theming + +The `background-color` and `foreground-color` tokens of the `mat.tabs-overrides` mixin only take +effect when the `backgroundColor` input is set, which is supported in M2 themes only. In M3 themes, +the label and indicator colors can be customized through tokens such as `active-label-text-color`, +`inactive-label-text-color` and `active-indicator-color`. See the +[styling page](https://material.angular.dev/components/tabs/styling) for the full list of tokens. + ### Accessibility `MatTabGroup` and `MatTabNavBar` both implement the [ARIA Tabs design pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/). Both components