<section class="info">
  <h1>Accordion</h1>
  <p>Base markup is <code>&lt;h2&gt;</code> with a <code>&lt;div&gt;</code> content panel below.</p>
  <p>JS inserts a <code>&lt;button&gt;</code> inside the <code>&lt;h2&gt;</code> to act as the toggle.</p>
  <p>JS also creates an unique ID for each element of every accordion item. This unique ID is used to make the association between toggle and content using the <code>aria-controls</code> attribute.</p>
  <p>Adding <code>.ch-accordion--animate</code> will animate panel open/close and arrow state. <code>.ch-accordion--animate</code> also sets the panel&rsquo;s max-height to 100vh. Content taller than 100vh (100% of screen height) will show an inner, vertical
  scroll bar.</p>
  <p>References:</p>
  <ul>
    <li><a href="https://davatron5000.github.io/a11y-nutrition-cards/components/accordion">Dave Rupert's accordion accessibility nutrition cards</a></li>
    <li><a href="https://github.com/scottaohara/a11y_accordions">Scott O'Hara's a11y_accordions</a></li>
    <li><a href="https://www.sarasoueidan.com/blog/accordion-markup/">Sara Soueidan's accordion markup overview</a></li>
    <li><a href="https://inclusive-components.design/collapsible-sections/">Inclusive Components' collapsible sections</a></li>
  </ul>
</section>

<div class="c-accordion c-accordion--animate">
  <div class="c-accordion__item">
    <h2 class="c-accordion__heading">Colors</h2>
    <div class="c-accordion__panel">
      <ul>
        <li>Red</li>
        <li>Orange</li>
        <li>Yellow</li>
        <li><a href="https://google.com/">Green</a></li>
        <li>Blue</li>
        <li>Indigo</li>
        <li>Violet</li>
      </ul>
    </div>
  </div>
  <div class="c-accordion__item">
    <h2 class="c-accordion__heading">Seasons</h2>
    <div class="c-accordion__panel">
      <ul>
        <li>Spring</li>
        <li>Summer</li>
        <li><a href="https://google.com/">Fall</a></li>
        <li>Winter</li>
      </ul>
    </div>
  </div>
  <div class="c-accordion__item">
    <h2 class="c-accordion__heading">Really long accordion text to force wrapping and still make room for icon</h2>
    <div class="c-accordion__panel">
      <p>Maxime placeat aut ut. Quam ut qui sunt magni voluptatibus sit et rerum. Dolorem et sed quod et et. Aliquam pariatur doloribus officiis. Repudiandae delectus enim excepturi quas nobis. Sint suscipit voluptatem corrupti. Ratione praesentium odio
        enim voluptatem repellendus. Non et consectetur libero sed eligendi.</p>
      <p>A voluptas vel consequatur aperiam placeat quod quia ut. Recusandae sed omnis ipsa architecto quod. Voluptatem cum architecto veniam sint voluptas. Et et rem qui illo consequatur ab. Eaque et molestiae tenetur tempore nam. Asperiores possimus officia
        maiores et pariatur officia. Veniam sint autem qui et. Eos tenetur illo laudantium amet aut molestiae.</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
      <p>Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est.
        Mauris placerat eleifend leo. Quisque sit amet est et sapien ullamcorper pharetra. Vestibulum erat wisi, condimentum sed, commodo vitae, ornare sit amet, wisi. Aenean fermentum, elit eget tincidunt condimentum, eros ipsum rutrum orci, sagittis
        tempus lacus enim ac dui. Donec non enim in turpis pulvinar facilisis. Ut felis. Praesent dapibus, neque id cursus faucibus, tortor neque egestas augue, eu vulputate magna eros eu erat. Aliquam erat volutpat. Nam dui mi, tincidunt quis, accumsan
        porttitor, facilisis luctus, metus</p>
    </div>
  </div>
</div>
.c-accordion {
  margin-top: 1rem;
  margin-bottom: 1rem;
}

.c-accordion__control {
  -webkit-appearance: none;
  background-color: inherit;
  border: 0;
  border-radius: 0;
  color: #000;
  cursor: pointer;
  display: block;
  font-size: 1rem;
  font-weight: normal;
  line-height: 1.5;
  padding: 0.25rem 0.75rem;
  padding-right: 3rem;
  position: relative;
  text-align: left;
  text-decoration: none;
  vertical-align: middle;
  width: 100%;
  z-index: 10;

  &:focus,
  &:hover {
    background-color: #f1f1f1;
  }

  &::after {
    background-image: url("data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMjUuNjIgMTkuMyIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJtMjEuODguOTNhMi44IDIuOCAwIDAgMSAyLjIzIDQuNWwtOS4xMSAxMS44N2EyLjc5IDIuNzkgMCAwIDEgLTMuOTEuNSAyLjYzIDIuNjMgMCAwIDEgLS41LS41bC05LjA2LTExLjg3YTIuOCAyLjggMCAwIDEgMi4yMy00LjV6IiBmaWxsPSIjMjIyIi8+PHBhdGggZD0ibTEyLjgyIDE3LjQyYTEuODYgMS44NiAwIDAgMSAtMS40OC0uNzNsLTkuMDYtMTEuODNhMS44NiAxLjg2IDAgMCAxIC4zMy0yLjYxIDEuOSAxLjkgMCAwIDEgMS4xNS0uMzloMTguMTJhMS44NiAxLjg2IDAgMCAxIDEuNDggM2wtOS4wNiAxMS44M2ExLjg2IDEuODYgMCAwIDEgLTEuNDguNzNtMCAxLjg4YTMuNjggMy42OCAwIDAgMCAzLTEuNDdsOS4wMy0xMS44M2EzLjczIDMuNzMgMCAwIDAgLTMtNmgtMTguMDlhMy43NCAzLjc0IDAgMCAwIC0zIDZsOS4wOSAxMS44M2EzLjY4IDMuNjggMCAwIDAgMyAxLjQ3eiIgZmlsbD0ibm9uZSIvPjwvc3ZnPgo="); // black rounded triangle
    background-position: center center;
    background-size: 1em 1em;
    content: " ";
    display: block;
    position: absolute;
    top: 0.5rem;
    right: 0.5rem;
    width: 1rem;
    height: 1rem;
    transform: rotate(0deg);
  }

  &[aria-expanded="true"] {
    &::after {
      transform: rotate(-180deg);
    }
  }
}

.c-accordion__panel {
  z-index: 1;

  &[aria-hidden="true"] {
    max-height: 0;
    overflow: hidden;
    padding: 0 0.75rem;
    visibility: hidden;
  }

  &[aria-hidden="false"] {
    padding: 0.75rem;
  }
}

.c-accordion--js {
  // zero out heading when JS is available
  .c-accordion__heading {
    font-size: inherit;
    line-height: 1;
    margin: 0;
    padding: 0;
  }
  // add borders when JS is available
  .c-accordion__item {
    border: 1px solid #ccc;
    margin-bottom: -1px; // avoid double border
  }
}

.c-accordion--animate {
  .c-accordion__control {
    @media screen and (prefers-reduced-motion: reduce) {
      &::after {
        transition: none;
      }
    }

    &::after {
      transition: transform 0.25s linear;
    }
  }

  .c-accordion__panel {
    @media screen and (prefers-reduced-motion: reduce) {
      &[aria-hidden="true"] {
        overflow: hidden;
        max-height: 0;
        position: relative;
        transition: none;
        visibility: hidden;
      }
    }

    &[aria-hidden="true"] {
      overflow: hidden;
      max-height: 0;
      position: relative;
      transition: all 0.25s ease-in-out;
      visibility: hidden;
    }

    @media screen and (prefers-reduced-motion: reduce) {
      &[aria-hidden="false"] {
        max-height: 100vh;
        overflow: auto;
        transition: none;
        visibility: visible;
      }
    }

    &[aria-hidden="false"] {
      max-height: 100vh;
      overflow: auto;
      transition: all 0.25s ease-in-out;
      visibility: visible;
    }
  }
}

// for codepen demo
body {
  padding: 2rem 5rem;
}
.info {
  background-color: #f1f1f1;
  padding: 1rem;
}
View Compiled
(function cAccordion () {
  'use strict';

  var component = "c-accordion";
  var components = document.querySelectorAll("." + component);
  var componentClassJS = component + "--js";
  var controlClass = component + "__control";
  var controlButton;
  var controlButtonText;
  var headingClass = component + "__heading";
  var headings;
  var panelClass = component + "__panel";
  var panels;
  var i;
  var j;

  for (i = 0; i < components.length; i++) {
    // Check create unique ID, add JS class on component container
    if (!components[i].hasAttribute("id")) {
      components[i].classList.add(componentClassJS);
      components[i].id = component + "-" + Math.floor(Math.random() * 999) + 1;
    }

    // Set up controls from headings
    headings = document.querySelectorAll(
      "#" + components[i].id + " ." + headingClass
    );
    for (j = 0; j < headings.length; j++) {
      // Get text from heading
      controlButtonText = headings[j].textContent;

      // Clear heading text
      headings[j].innerHTML = "";

      // Create inner button, click listener
      controlButton = document.createElement("button");
      controlButton.setAttribute("type", "button");
      controlButton.setAttribute("aria-expanded", "false");
      controlButton.setAttribute(
        "aria-controls",
        components[i].id + "-panel-" + (j + 1)
      );
      controlButton.setAttribute("id", components[i].id + "-control-" + (j + 1));
      controlButton.classList.add(controlClass);
      controlButton.addEventListener("click", controlClick, false);

      // Insert button, add text from heading
      headings[j].appendChild(controlButton);
      controlButton.appendChild(document.createTextNode(controlButtonText));
    }

    // Set up panels
    panels = document.querySelectorAll(
      "#" + components[i].id + " ." + panelClass
    );
    for (j = 0; j < panels.length; j++) {
      panels[j].setAttribute("aria-hidden", "true");
      panels[j].setAttribute("id", components[i].id + "-panel-" + (j + 1));
    }
  }

  function controlClick(event) {
    var thisControl = document.querySelectorAll("#" + event.target.id);
    var thisPanel = document.querySelectorAll(
      "#" + thisControl[0].getAttribute("aria-controls")
    );

    event.preventDefault();

    if (thisControl[0].getAttribute("aria-expanded") === "true") {
      thisControl[0].setAttribute("aria-expanded", "false");
      thisPanel[0].setAttribute("aria-hidden", "true");
    } else {
      thisControl[0].setAttribute("aria-expanded", "true");
      thisPanel[0].setAttribute("aria-hidden", "false");
    }
  }
}());

External CSS

This Pen doesn't use any external CSS resources.

External JavaScript

This Pen doesn't use any external JavaScript resources.