Accordions
Native HTML accordion styles for grouped <details> disclosure elements.
Examples (anchor)
Please note. The accordions will inherit whatever normalize/reset styles are present requiring only minor adjustments to suit base font property values, but as demonstrated they've been designed to work seamlessly with the StyleMods content styles.
Default (anchor)
Summary
Body text
Summary
Body text
Summary
Body text
Example HTML
<div class="accordion mb-3">
<details name="accordion-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-demo">
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-demo">
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
</div>Fixed light and dark (anchor)
Summary
Body text
Summary
Body text
Summary
Body text
Summary
Body text
Summary
Body text
Summary
Body text
Example HTML
<div class="accordion accordion-light">
<details name="accordion-light-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-light-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-light-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
</div>
<div class="accordion accordion-dark">
<details name="accordion-dark-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-dark-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
<details name="accordion-dark-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
</div>Using the module (anchor)
Load StyleMods as demonstrated (change file path as required) then include the Sass mixin anywhere below.
custom.scss
@use "stylemods/scss" as *;
@include accordions-css;See the using modules page for more information including how to compile the modules in cascade layers and include and reuse them in multiple source files.
Using the framework (anchor)
Using the recommended custom setup enable the styles in an overrides document:
overrides.scss
@use "stylemods/scss/configuration" as *;
$enable-accordions: true;Include the overrides and the framework styles with your custom document for compiling the framework:
custom.scss
@use "overrides";
@use "stylemods/scss/stylemods";See using the framework for more information including how the styles can also be compiled within cascade layers.
Source code (anchor)
The modules and the framework follow the same methods for customizing the default values and using the CSS variables to create custom theme documents. See the customizing page for more information.
accordions.scss
// ----------------------------------------------------------
// Accordions
// ----------------------------------------------------------
$summary-text-color: var(--summary-text, CanvasText) !default;
$summary-background-color: var(--summary-bg, color-mix(in srgb, CanvasText 4%, Canvas)) !default;
$summary-background-focus: var(--summary-focus, color-mix(in srgb, CanvasText 8%, Canvas)) !default;
$accordion-padding-block: var(--accordion-py, 0.75rem) !default;
$accordion-padding-inline: var(--accordion-px, 1rem) !default;
$accordion-border-color: var(--accordion-bd-color, color-mix(in srgb, CanvasText 15%, Canvas)) !default;
$accordion-radius: var(--accordion-radius, 0.188rem) !default;
$accordion-inner-radius: calc($accordion-radius - 1px) !default;
// Icon options
$accordion-icon-color: $summary-text-color !default;
$accordion-plus-icon: url("data:image/svg+xml,<svg viewBox='0 0 16 16' fill='currentColor' xmlns='http://www.w3.org/2000/svg'><path d='m7 2v5h-5v2h5v5h2v-5h5v-2h-5v-5h-2z'/></svg>") !default;
$accordion-minus-icon: url("data:image/svg+xml,<svg viewBox='0 0 16 16' fill='currentColor' xmlns='http://www.w3.org/2000/svg'><path d='m2 9v-2h12v2z'/></svg>") !default;
$accordion-caret-down-icon: url("data:image/svg+xml,<svg viewBox='0 0 16 16' fill='currentColor' xmlns='http://www.w3.org/2000/svg'><path d='m8 10-4-4h8z'/></svg>") !default;
$accordion-caret-up-icon: url("data:image/svg+xml,<svg viewBox='0 0 16 16' fill='currentColor' xmlns='http://www.w3.org/2000/svg'><path d='m8 6 4 4-8 7e-7z'/></svg>") !default;
// Open/close icons
$open-accordion: $accordion-plus-icon !default;
$close-accordion: $accordion-minus-icon !default;
@mixin accordions-css {
.accordion {
border: 1px solid $accordion-border-color;
border-radius: $accordion-radius;
}
.accordion details {
margin-block-end: 0;
}
.accordion details summary {
color: $summary-text-color;
list-style-type: "";
border-block-end: 1px solid $accordion-border-color;
padding-block: $accordion-padding-block;
padding-inline: $accordion-padding-inline;
background-color: $summary-background-color;
}
.accordion details summary::-webkit-details-marker {
display: none;
}
.accordion details summary:focus-visible {
outline: none;
background-color: $summary-background-focus;
}
.accordion details:first-child summary {
border-start-start-radius: $accordion-inner-radius;
border-start-end-radius: $accordion-inner-radius;
}
.accordion details:last-child summary {
border-block-end: none;
border-end-start-radius: $accordion-inner-radius;
border-end-end-radius: $accordion-inner-radius;
}
.accordion details[open]:last-child summary {
border-block-end: 1px solid $accordion-border-color;
border-radius: 0;
}
.accordion details[open] summary {
margin-block-end: 0;
}
.accordion summary + div {
padding-block: $accordion-padding-block;
padding-inline: $accordion-padding-inline;
border-block-end: 1px solid $accordion-border-color;
}
.accordion details[open]:last-child summary + div {
border-block-end: none;
}
.accordion summary + div * {
margin-block-start: 0;
}
.accordion details *:last-of-type {
margin-block-end: 0;
}
.accordion details summary:after {
--svg: #{$open-accordion};
display: inline-block;
content: "";
block-size: 1em;
inline-size: 1em;
background-color: $accordion-icon-color;
mask-image: var(--svg);
mask-repeat: no-repeat;
float: right;
margin-block-start: calc(1em / 4);
margin-inline-start: 1rem;
}
.accordion details[open] summary:after {
--svg: #{$close-accordion};
}
.accordion-light {
color-scheme: light;
}
.accordion-dark {
color-scheme: dark;
}
} // end accordions-css