Wyjątkowa akordeon

Utwórz wyłączne menu uruchamiane z wieloma elementami <details> o tym samym name.

Bramus

Akordeon

Typowym wzorcem interfejsu użytkownika w internecie jest komponent harmonijka. Jest to komponent składający się z kilku widżetów, które można rozwinąć (lub zwinąć), aby wyświetlić (lub ukryć) ich zawartość.

Aby zastosować ten wzorzec w internecie, należy połączyć kilka elementów <details> i zwykle grupować je wizualnie, aby pokazać, że należą do siebie.

Wyjątkowy akordeon

Wariantem schematu akordeonu jest akordeon wykluczający, w którym można otworzyć tylko jeden z widżetów.

Aby utworzyć wyłączny akordeon w internecie, dodaj atrybut name do elementów <details>. Gdy używasz tego atrybutu, wiele elementów <details> o tej samej wartości name tworzy grupę semantyczną i zachowuje się jak akordeon wyłączny. Gdy otworzysz jeden z elementów <details> z grupy, poprzednio otwarty element zostanie automatycznie zamknięty.

<details name="learn-css">
  <summary>Welcome to Learn CSS!</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Box Model</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Selectors</summary>
  <p>…</p>
</details>

Strona może zawierać wiele wyłącznych harmonijek. Za każdym razem, gdy użyjesz nowej wartości name w elemencie <details>, zostanie utworzona nowa grupa logiczna.

Elementy <details>, które są częścią wyłącznego elementu accordion, nie muszą być elementami braćmi. Mogą być rozproszone po całym dokumencie. Elementy są grupowane według atrybutu name, a nie ich kolejności w DOM.

Polyfill na akordeonu wyjątkowego

Poniższy kod JavaScript umożliwia polyfill na podstawie działania akordeonu wykluczającego. Kod korzysta ze zdarzenia toggle elementu <details>.

Gdy otwiera się element <details> z atrybutem name, kod znajduje inne otwarte elementy <details> z tą samą wartością atrybutu name i zamyka je.

document.querySelectorAll("details[name]").forEach(($details) => {
  $details.addEventListener("toggle", (e) => {
    const name = $details.getAttribute("name");

    if (e.newState == "open") {
      document
        .querySelectorAll(`details[name=${name}][open]`)
        .forEach(($openDetails) => {
          if (!($openDetails === $details)) {
            $openDetails.removeAttribute("open");
          }
        });
    }
  });
});

Niektóre starsze wersje przeglądarek nie wywołują tego zdarzenia toggle. W tych przeglądarkach kod polyfill nie będzie działać. Jeśli chodzi o stopniowe ulepszanie, jest to dozwolone.