Attiva/disattiva la visibilità di contenuti con l’ausilio di alcune classi e di plug-in JavaScript.
Per ottimizzare l’ingombro dei contenuti di una pagina si possono usare degli 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
Puoi usare un bottone con l’attributo data-target o in alternativa un link con l’attributo href. In entrambi i casi, l’attributo data-toggle="collapse" è obbligatorio.
L’interazione con i bottoni cambierà le seguenti classi dell’elemento richiudibile:
.collapse nasconde il contenuto
.collapsing viene applicata durante la transizione
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Attivazione di elementi richiudibili
Un <button> o un <a> può mostrare o nascondere più elementi facendo riferimento ad essi con un selettore jQuery nell’attributo href o nell’attributo data-target.
Molteplici <button> o <a> possono mostrare o nascondere un elemento se ognuno di loro fa riferimento ad esso con i loro attributi href o data-target.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Gruppi di elementi richiudibili
Gli elmenti richiudibili sono molto spesso mostrati in gruppo, tipicamente usati per approfondire voci o argomenti mostrati nelle singole barre cliccabili.
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-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.
L’elemento richiudibile deve avere un role="region" con attributo aria-labelledby associato all’id del suo elemento di controllo.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Accordion
Per ottenere un gruppo di elementi mutuamente richiudibili (o accordion), è sufficiente aggiungere ad ogni elemento .collapse l’attributo data-parent con il relativo ID del contenitore padre.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Collapse e accordion annidati
Più gruppi di collapse o accordion possono essere annidati.
Accessibilità collapse e accordion annidati
Utilizzare questo approccio solo quando strettamente necessario: dal punto di vista dell’accessibilità non si tratta di una soluzione ottimale.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Sfondo primario
Applicando classi aggiuntive al wrapper .collapse-div è possibile utilizzare il colore primario come sfondo degli header.
Header attivi
Aggiungere la classe .collapse-background-active al wrapper per ottenere header con sfondo di colore primario quando questi sono attivi e il contenuto relativo è visibile.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Hover degli Header
Aggiungere la classe .collapse-background-hover al wrapper per ottenere header con sfondo di colore primario all’hover.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
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.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch.
Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Implementazione
Tramite data attributes
Basta aggiungere data-toggle="collapse" e un data-target all’elemento per assegnare automaticamente il controllo di uno o più elementi richiudibili. L’attributo data-target accetta un selettore CSS per rendere l’elemento richiudibile. Assicurati di aggiungere la classe collapse all’elemento richiudibile. Se desideri che l’impostazione predefinita sia aperta, aggiungi la classe aggiuntiva show.
Per aggiungere un’impostazione tipo accordion ad un’area richiudibile, aggiungi l’attributo data-parent="#selector". Fai riferimento alla demo per vederlo in azione.
Tramite JavaScript
Abilitarlo manualmente con:
$('.collapse').collapse()
Opzioni
Le opzioni possono essere passate tramite gli attributi data o tramite Javascript. Per quanto riguarda gli attributi data, aggiungi il nome dell’opzione a data-, come in data-parent="".
Nome
Tipo
Predefinito
Descrizione
parent
selector | jQuery object | DOM element
false
Se presente un genitore, allora tutti gli elementi comprimibili sotto il genitore specificato verranno chiusi quando viene mostrato questo elemento richiudibile. (simile al tradizionale comportamento dell'accordion - questo dipende dalla classe card class). L'attributo deve essere impostato sull'area comprimibile associata.
toggle
boolean
true
Attiva/disattiva l'elemento richiudibile su richiesta
Metodi
Metodi asincroni e transizioni
Tutti i metodi API sono asincroni e avviano una transizione. Ritornano al chiamante non appena viene avviata la transizione ma prima che termini. Inoltre, una chiamata al metodo su un componente in transizione verrà ignorata.
Attiva i tuoi contenuti come elementi richiudibili. Accetta un’opzione facoltativa object.
$('#myCollapsible').collapse({toggle:false,})
.collapse('toggle')
Attiva/disattiva un elemento richiudibile per mostrarlo o nasconderlo. Ritorna al chiamante prima che l’elemento richiudibile sia stato effettivamente mostrato o nascosto (i.e. si verifica prima dell’evento shown.bs.collapse o hidden.bs.collapse).
.collapse('show')
Mostra un elemento richiudibile. Ritorna al chiamante prima che l’elemento richiudibile sia stato effettivamente mostrato (i.e. si verifica prima dell’evento shown.bs.collapse).
.collapse('hide')
Nasconde un elemento richiudibile. Ritorna al chiamante prima che l’elemento richiudibile sia stato effettivamente nascosto (i.e. si verifica prima dell’evento hidden.bs.collapse).
.collapse('dispose')
Elimina la possibilità di un elemento di essere richiudibile.
Eventi
La classe .collapse di Bootstrap espone alcuni eventi per agganciare comportamenti alla funzionalità di apertura/chiusura attraverso Javascript.
Tipo di evento
Descrizione
show.bs.collapse
Questo evento si attiva immediatamente quando il metodo di istanza show viene richiamato.
shown.bs.collapse
Questo evento viene attivato quando un elemento richiudibile è stato reso visibile all'utente (attenderà il completamento delle transizioni CSS).
hide.bs.collapse
Questo evento si attiva immediatamente quando il metodo hide viene richiamato.
hidden.bs.collapse
Questo evento viene attivato quando un elemento richiudibile è stato nascosto all'utente (attenderà il completamento delle transizioni CSS).
$('#myCollapsible').on('hidden.bs.collapse',function(){// do something…})