Skip to content

Commit 2d2122b

Browse files
deanbotdeanbot
committed
first pass at theme slot remarks via Laura's article
1 parent 8058373 commit 2d2122b

File tree

1 file changed

+31
-11
lines changed

1 file changed

+31
-11
lines changed

‎docs/spfx/use-theme-colors-in-your-customizations.md

Lines changed: 31 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -46,18 +46,37 @@ The following theme tokens are available for you to use:
4646

4747
| Token | Default value on a modern team site using the red palette | Remarks |
4848
| -------------------- | --------------------------------------------------------- | -------------------------------------------------------------- |
49-
| `backgroundImageUri` | `none` | |
50-
| `accent` | `#ee0410` | |
51-
| `themeDark` | `#b3030c` | Used for action icons in the command bar and as a hover color. |
52-
| `themeDarkAlt` | `#b3030c` | |
53-
| `themeDarker` | `#770208` | |
54-
| `themeLight` | `#fd969b` | |
49+
| `themeDark` | `#b3030c` | Some button onclick and link color (e.g., “Return to classic SharePoint”). Header “Follow” star icon if the third header background color option is used. System pages: OK button border and hover. |
50+
| `themeDarkAlt` | `#b3030c` | Many icons (e.g., in the command bar), some borders, button/link hovers, spinner background, range element focus, checkbox background hover, web parts and lists, button hover, range element focus, add web part icon when the third section background color is selected. |
51+
| `themeDarker` | `#770208` | Hover color for some links. System pages: Visited link color. |
52+
| `themeLight` | `#fd969b` | Range selector hover and focus background. Loading spinner background color in site contents view. |
5553
| `themeLightAlt` | `#fd969b` | |
56-
| `themeLighter` | `#fecacd` | |
57-
| `themeLighterAlt` | `#fecacd` | |
58-
| `themePrimary` | `#ee0410` | Primary theme color. Used for icons and default buttons. |
59-
| `themeSecondary` | `#fc6169` | |
60-
| `themeTertiary` | `#fd969b` | |
54+
| `themeLighter` | `#fecacd` | Navigation edit menu background color, add web part panel hover background color, image background color in some web parts when the third section background color option is selected. System pages: Navigation hover background, cancel button hover background. |
55+
| `themeLighterAlt` | `#fecacd` | One of the section background options. Cogwheel menu hover background in site contents view. |
56+
| `themePrimary` | `#ee0410` | Some button and checkbox backgrounds, links, texts, borders and icons, icon and link hovers. Also the footer background color, and one of the section background options. System pages: OK button background, link texts. |
57+
| `themeSecondary` | `#fc6169` | The suite bar text color in site contents view. Hover color for some links. Image background color in some web parts when the fourth section background color is selected. The second color in the palette icon in the “Change the look panel” (hence the token name) |
58+
| `themeTertiary` | `#fd969b` | Add web part icon when the fourth selection background color is selected. The third color in the palette icon in the “Change the look panel” (hence the token name) |
59+
| `neutralDark` | `` | Some button, link and border hover text color, some icons. System pages: page breadcrumb, header texts. |
60+
| `neutralLight` | `` | Some web part borders, command bar action hover, command bar background when a list item is selected, list view category header background when an item is selected, button hover. System pages: Ribbon tab background, OK button border, selected navigation element background, disabled text box border. Divider web part. Image background color in some web parts when the second section background color option is selected. |
61+
| `neutralLighter` | `` | Some menu backgrounds (e.g., the command bar), selected left navigation element, some button backgrounds, ome option for a section background color. |
62+
| `neutralLighterAlt` | `` | Left navigation hover background color, list info panel text background, image background color in some webparts when the first section background color is selected, some icons and texts when editing web parts. System pages: Cancel button background, disabled text box background. |
63+
| `neutralPrimary` | `` | Site header texts, texts in navigation menux, command bar, buttons and web parts, web part related icon backgrounds when the page is in edit mode, add web part panel icons and texts, web part settings panel texts. System pages: dropdown arrow color, some texts. |
64+
| `neutralPrimaryAlt` | `` | The suite bar background color in site contents view. |
65+
| `neutralSecondary` | `` | Some menu texts, empty library text, some icon hover backgrounds, some texts in web parts, command bar arrows, range selector. System pages: link color, some icons, and borders. |
66+
| `neutralTertiary` | `` | Some button texts, some web part titles, some web part setting texts, some web part icons, border hover color in some web parts, dashed section border color in edit mode, web part settings panel control border color. Most visible when editing web parts. System pages: text box, dropdown, and button border color. |
67+
| `neutralTertiaryAlt` | `` | Some texts, e.g., in web part property pane, some icons in web parts, range selector background, some button onclick background color, yes/no toggle control background, change section background color setting border color. |
68+
| `neutralQuaternary` | `` | Command bar action hover background when a list item is selected. System pages: Borders |
69+
| `neutralQuaternaryAlt` | `` | Info icon and selected ellipses background in lists, some web part element backgrounds when in edit mode, web part property pane dropdown item background color, selected list item background. |
70+
| `backgroundImageUri` | `none` | |
71+
| `accent` | `#ee0410` | The fourth color in the palette in the “Change the look” panel. |
72+
| `black` | `` | Web part settings panel dropdown text color, carousel controls, site contents tab text hover, “Change the look” panel texts. |
73+
| `white` | `` | Primary body background color, some icon hover color, one of the available section background colors. System pages: Body background color |
74+
| `whiteTranslucent40` | `` | Covers the rest of page when a modal dialog is opened. A solid color can be specified to get rid of transparency. |
75+
| `backgroundOverlay` | `` | Header background, comment section background, some borders, site contents primary background color |
76+
| `primaryBackground` | `` | Some backgrounds when editing web part settings, some text field backgrounds, cogwheel menu background in site contents view. |
77+
| `primaryText` | `` | Edit section icons. Cogwheel menu texts in site contents view. |
78+
79+
6180

6281
> [!NOTE]
6382
> There are more tokens registered with the SharePoint Framework. While all of them have values specified on classic sites, only the subset mentioned earlier has values on modern SharePoint sites. For the complete list of available tokens, see the value of the `window.__themeState__.theme` property by using the console in your web browser's developer tools.
@@ -107,3 +126,4 @@ When you scaffold a new SharePoint Framework client-side web part, by default, i
107126

108127
- [SharePoint themes and colors](../design/themes-colors.md)
109128
- [How to use Theme Colors in SPFX web parts](https://n8d.at/blog/how-to-use-theme-colors-in-spfx-web-parts/) by Stefan Bauer (Office Development MVP)
129+
- [How to Create a Multicolored Theme for a Modern SharePoint Online Site](https://laurakokkarinen.com/how-to-create-a-multicolored-theme-for-a-modern-sharepoint-online-site/) by Laura Kokkarinen (SharePoint PnP Core MVP)

0 commit comments

Comments
 (0)