{% set paletteURL = '/docs/palettes/' + palette + '/' %}
@@ -27,14 +81,14 @@ You can import this theme from the Web Awesome CDN.
{% set stylesheet = 'styles/themes/' + page.fileSlug + '.css' %}
{% include 'import-stylesheet-code.md.njk' %}
-### Mixing & Matching
+### Remixing { #remixing }
-If you want to combine the colors from this theme with another theme, you can import this CSS file *after* the other theme’s CSS file:
+If you want to combine the **colors** from this theme with another theme, you can import this CSS file *after* the other theme’s CSS file:
{% set stylesheet = 'styles/themes/' + page.fileSlug + '/color.css' %}
{% include 'import-stylesheet-code.md.njk' %}
-To use the typography from this theme with another theme, you can import this CSS file *after* the other theme’s CSS file:
+To use the **typography** from this theme with another theme, you can import this CSS file *after* the other theme’s CSS file:
{% set stylesheet = 'styles/themes/' + page.fileSlug + '/typography.css' %}
{% include 'import-stylesheet-code.md.njk' %}
diff --git a/docs/assets/styles/docs.css b/docs/assets/styles/docs.css
index 36170bcbf..7f5cd5733 100644
--- a/docs/assets/styles/docs.css
+++ b/docs/assets/styles/docs.css
@@ -536,4 +536,23 @@ table.colors {
height: 65vh;
max-height: 21lh;
}
+
+ #mix_and_match {
+ strong {
+ display: flex;
+ align-items: center;
+ gap: var(--wa-space-2xs);
+ margin-top: 1.2em;
+ }
+
+ wa-select::part(label) {
+ margin-block-end: 0;
+ }
+
+ wa-select[value='']::part(display-input),
+ wa-option[value=''] {
+ font-style: italic;
+ color: var(--wa-color-text-quiet);
+ }
+ }
}
diff --git a/docs/docs/native/select.md b/docs/docs/native/select.md
index 28179161f..efef8547f 100644
--- a/docs/docs/native/select.md
+++ b/docs/docs/native/select.md
@@ -33,3 +33,39 @@ Use the [appearance utilities](/docs/utilities/appearance/) to change the select
```
+
+### Grouping options
+
+In [modern browsers](https://caniuse.com/mdn-html_elements_select_hr_in_select), you can use the `` element as a divider:
+
+```html {.example}
+
+```
+
+To provide labels, you can use the `