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)

To use the module load the StyleMods scss directory as follows (changing the path to suit the source files location as required) then include the Sass mixin anywhere below.

custom.scss

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

Source code (anchor)

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

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