Accordions

Native HTML accordions created using a wrapper style for grouped <details> disclosure elements.

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 then include the Sass mixin anywhere below.

custom.scss

@use "sassmods/scss/sassmods" as *;
@include accordions-css;

See customizing for information about using the Sass and CSS variables in the source code (see below) to customize the styles, and Sass variables (on the using SassMods page) for other ways to use the variables to create custom styles.

Source

accordions.scss

// ---------------------------------------------------------- 
// Accordions
// ----------------------------------------------------------
$summary-text-color:        var(--summary-text, CanvasText) !default;
$summary-background-color:  var(--summary-bg, color-mix(in srgb, CanvasText 3%, Canvas)) !default;
$summary-focus-color:       var(--summary-focus, color-mix(in srgb, CanvasText 5%, 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 12%, Canvas)) !default;
$accordion-radius:          var(--accordion-radius, 0.188rem) !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 {
  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-focus-color;
}

.accordion details:first-child summary {
  border-start-start-radius: calc($accordion-radius - 1px);
  border-start-end-radius: calc($accordion-radius - 1px);
}

.accordion details:last-child summary {
  border-block-end: none;
  border-end-start-radius: calc($accordion-radius - 1px);
  border-end-end-radius: calc($accordion-radius - 1px);
}

.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: #{$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};
}

} // end accordions-css