Accordions

Accordion styles for grouped <details> disclosure elements that can be customized with variables globally or inline.

Example

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" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>

<details name="accordion-demo" open>
<summary>Summary</summary>
<div>
<p>Body text</p>
</div>
</details>
</div>

Using the module

Add the sassmods.scss to your custom styles as below, use the Sass variables from the module's source code (see below) to customize the default property values if required, then include the Sass mixin anywhere below.

@use "sassmods/scss/sassmods" as *;
$accordion-padding-block: 0.25rem; // example
$accordion-padding-inline: 0.5rem; // example

@include accordions-css;

Using the framework

Enable the module in the sassmods-system.scss document as below, if required customize the styles or the Sass variables for the default property values directly in the source code (see below).

$enable-accordions: true;

Source

The source code is a self-contained Sass document that compiles the style modules as Sass mixins using Sass variables provided for the core property values that can be customized as described above.

_accordions.scss

Use the property specific CSS variables to create root level variables for global styles and/or editing inline, or change all the values to suit your own parameters.

// ---------------------------------------------------------- 
// Accordions
// ----------------------------------------------------------
$summary-text-color:        var(--summary-text, CanvasText) !default;
$summary-background-color:  var(--summary-bg, color-mix(in srgb, CanvasText 3%, Canvas)) !default;
$accordion-border-color:    var(--accordion-border, color-mix(in srgb, CanvasText 12%, Canvas)) !default;
$accordion-padding-block:   var(--accordion-py, 0.75rem) !default;
$accordion-padding-inline:  var(--accordion-px, 1rem) !default;
$accordion-closed-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-open-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;

@mixin accordions-css {

.accordion details {
  margin-block-end: 0;
  border-inline: 1px solid #{$accordion-border-color};
}

.accordion details summary {
  color: #{$summary-text-color};
  list-style-type: "";
  border-block-start: 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[open] summary {
  margin-block-end: 0;
  border-block-end: 1px solid #{$accordion-border-color};
}

.accordion details:last-of-type summary {
  border-block-end: 1px solid #{$accordion-border-color};
}

.accordion details summary:after {
  --svg: #{$accordion-closed-icon};
  display: inline-block;
  content: "";
  block-size: 1em;
  inline-size: 1em;
  background-color: var(--summary-text, CanvasText);
  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: #{$accordion-open-icon};
}

.accordion summary + div {
  padding-block: #{$accordion-padding-block};
  padding-inline: #{$accordion-padding-inline};
}

.accordion summary + div * {
  margin-block-start: 0;
}

.accordion details:last-of-type[open] summary + div {
  border-block-end: 1px solid #{$accordion-border-color};
}

.accordion details *:last-of-type {
  margin-block-end: 0;
}

} // end accordions-css