Collapse
Elementi richiudibili (in gergo definiti collassabili o collapse), che possono essere attivati indipendentemente l’uno dall’altro oppure in modo esclusivo con l’attivazione di solo un blocco alla volta (in gergo definiti fisarmoniche o accordion).
Come funziona
Per ottenere un gruppo di elementi mutuamente richiudibili (o collapse), è sufficiente aggiungere ad ogni elemento .collapse l’attributo data-parent con il relativo ID del contenitore padre.
<div class="accordion" id="collapseExample">
<div class="accordion-item">
<h2 class="accordion-header " id="heading1c">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapse1c" aria-expanded="true" aria-controls="collapse1c">
Elemento Richiudibile #1
</button>
</h2>
<div id="collapse1c" class="accordion-collapse collapse show" role="region" aria-labelledby="heading1c">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
<div class="accordion-item">
<h2 class="accordion-header " id="heading2c">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapse2c" aria-expanded="false" aria-controls="collapse2c">
Elemento Richiudibile #2
</button>
</h2>
<div id="collapse2c" class="accordion-collapse collapse" role="region" aria-labelledby="heading2c">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>Accessibilità
Assicurati di aggiungere aria-expanded all’elemento di controllo. Questo attributo trasmette esplicitamente lo stato corrente dell’elemento comprimibile legato al controllo a screen reader e tecnologie assistive simili. Se l’elemento comprimibile è chiuso in modo predefinito, l’attributo sull’elemento di controllo dovrebbe avere il valore aria-expanded="false". Se imposti l’elemento comprimibile aperto in modo predefinito utilizzando la classe show, sul controllo invece imposta aria-expanded="true". Il plugin attiva/disattiva automaticamente questo attributo sul controllo in base all’apertura o alla chiusura dell’elemento richiudibile (via JavaScript, o perché l’utente ha attivato un altro elemento di controllo anch’esso legato allo stesso elemento richiudibile). Se il componente HTML dell’elemento di controllo non è un bottone (ad esempio un <a> o <div>), l’attributo role="button" dovrebbe essere aggiunto al componente.
Inoltre, se il tuo elemento di controllo si riferisce a un singolo elemento richiudibile – cioè l’attributo data-bs-target sta puntando a un selettore id – potresti aggiungere un ulteriore attributo aria-controls all’elemento di controllo, contenente l’id dell’elemento richiudibile. I moderni screen reader e tecnologie assistive simili fanno uso di questo attributo per fornire agli utenti scorciatoie aggiuntive per navigare direttamente all’elemento richiudibile stesso.
Al momento Bootstrap non copre la gestione dei comandi attraverso tastiera descritte nelle WAI-ARIA Authoring Practices 1.1 accordion pattern - è quindi necessario includerle separatamente attraverso JavaScript.
Header attivi e hover
Applicando classi aggiuntive al wrapper .collapse-div è possibile utilizzare il colore primario come sfondo degli header.
Aggiungere la classe .accordion-background-active al wrapper per ottenere header con sfondo di colore primario quando questi sono attivi e il contenuto relativo è visibile.
<div class="accordion accordion-background-active" id="accordionExampleHa">
<div class="accordion-item">
<h2 class="accordion-header " id="heading1b">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapse1b" aria-expanded="true" aria-controls="collapse1b">
Elemento Accordion #1
</button>
</h2>
<div id="collapse1b" class="accordion-collapse collapse show" data-bs-parent="#accordionExampleHa" role="region" aria-labelledby="heading1b">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
<div class="accordion-item">
<h2 class="accordion-header " id="heading2b">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapse2b" aria-expanded="false" aria-controls="collapse2b">
Elemento Accordion #2
</button>
</h2>
<div id="collapse2b" class="accordion-collapse collapse" data-bs-parent="#accordionExampleHa" role="region" aria-labelledby="heading2b">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
</div>Aggiungere la classe .collapse-background-hover al wrapper per ottenere header con sfondo di colore primario all’hover.
<div class="accordion accordion-background-hover" id="accordionExampleHh">
<div class="accordion-item">
<h2 class="accordion-header " id="heading1d">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapse1d" aria-expanded="true" aria-controls="collapse1d">
Elemento Accordion #1
</button>
</h2>
<div id="collapse1d" class="accordion-collapse collapse show" data-bs-parent="#accordionExampleHh" role="region" aria-labelledby="heading1d">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
</div>Icona a sinistra
Aggiungendo la classe .collapse-left-icon al wrapper si ottiene una variante in cui l’icona chevron che indica lo stato di apertura è sostituita da segni meno/più allineati a sinistra del titolo dell’header.
<div class="accordion accordion-left-icon" id="accordionExampleLft">
<div class="accordion-item">
<h2 class="accordion-header " id="heading1l">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapse1l" aria-expanded="true" aria-controls="collapse1l">
Elemento Accordion #1
</button>
</h2>
<div id="collapse1l" class="accordion-collapse collapse show" data-bs-parent="#accordionExampleLft" role="region" aria-labelledby="heading1l">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
<div class="accordion-item">
<h2 class="accordion-header " id="heading2l">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapse2l" aria-expanded="false" aria-controls="collapse2l">
Elemento Accordion #2
</button>
</h2>
<div id="collapse2l" class="accordion-collapse collapse" data-bs-parent="#accordionExampleLft" role="region" aria-labelledby="heading2l">
<div class="accordion-body">
Vestibulum hendrerit ultrices nibh, sed pharetra lacus ultrices eget. Morbi et ipsum et sapien dapibus facilisis. Integer eget semper nibh. Proin enim nulla, egestas ac rutrum eget, ullamcorper nec turpis.
</div>
</div>
</div>
</div>
Accessibilità
Il componente Accordion si basa su quello nativo di Bootstrap 5.2.3, a sua volta basato sul componente Collapse.
Bootstrap Italia migliora l’accessibilità dell’Accordion implementando la navigazione via tastiera degli header con le frecce cursore (su/giù) e con i tasti Home (primo elemento) ed End (ultimo elemento).