Carousel (versione legacy)
Owl Carousel OBSOLETO!
Il plugin Owl Carousel utilizzato da Bootstrap Italia per il componente Carousel, non è più supportato.
Questa versione legacy del Carousel è lasciata ancora disponibile solo per non costringere al passaggio immediato al nuovo plugin.
Nota: per fare funzionare il vecchio plugin però è necessario seguire le istruzioni specifiche contenute nel paragrafo Implementazione nella relativa Documentazione di Bootstrap Italia.
Si raccomanda inoltre di sostituirlo con il nuovo il prima possibile.
E’ costituito da:
- uno spazio in cui scorre una serie di card oppure di immagini, eventualmente con una immagine di sfondo
- una fila di punti cliccabili che rappresentano gli elementi della serie evidenziando la posizione di quello visualizzato al momento e che permettono di saltare immediatamente ad uno qualsiasi di essi.
Facoltativamente può avere anche:
- una intestazione con il titolo della sequenza
- due frecce per avanzare o tornare indietro di un passo
- uno scorrimento automatico temporizzato
Struttura
Contenitore principale
Un tag div con classi it-carousel-wrapper e it-carousel-landscape-abstract-three-cols.
Titolo
All’interno del contenitore principale può essere inserito un div di classe it-header-block ed il testo a sua volta inserito in un ulteriore div di classe it-header-block-title.
Contenitore delle card
Al di sotto dell’eventuale titolo, il div con le classi it-carousel-all e owl-carousel, in cui scorreranno le card o immagini, .
A queste possono essere aggiunte una serie di ulteriori classi utili per dimensionare e distanziare tra loro le card/immagini: it-card-bg, it-img-card, it-big-img e it-standard-image. Verranno spiegate poi nel dettaglio.
Sempre allo stesso div contenitore delle card/immagini possono essere applicate altre due classi, specifiche di Bootstrap Regione Lombardia: it25-carousel-nav e it25-carousel-autoplay.
Servono rispettivamente a far comparire le frecce di avanti/indietro di un passo (di default non compaiono), e ad attivare lo scorrimento automatico ogni 5 secondi.
Serie di wrapper uno per ogni elemento
All’interno del contenitore delle card, un div di classe it-single-slide-wrapper per ogni slide della serie da far scorrere.
A sua volta all’interno dei questo wrapper un ulteriore div di classe card-wrapper, necessario anche se il contenuto è in realtà un immagine.
Eventualmente può essere agginta a questo anche la classe card-space per distanziare gli elementi tra di loro.
Esempi
Titolo e Card
Titolo del Carousel
<div class="it-carousel-wrapper it-carousel-landscape-abstract-three-cols">
<div class="it-header-block">
<div class="it-header-block-title">
<h2 class="no_toc">Titolo del Carousel</h2>
</div>
</div>
<div class="it-carousel-all owl-carousel it-card-bg">
<div class="it-single-slide-wrapper">
<div class="card-wrapper card-space">
include esempi-lombardia/card_semplice.html
</div>
</div>
. . .
. . .
</div>
</div>In questo esempio sono state usate in particolare le classi:
it-header-blockeit-header-block-titleper i div nidificati contenenti il titoloit-card-bgsul div del contenitore delle cardcard-spacesu tutti i div contenti le singole card per distanziarle tra loro.
Immagini grandi
<div class="it-carousel-wrapper it-carousel-landscape-abstract-three-cols">
<div class="it-carousel-all owl-carousel it-img-card it-big-img it25-carousel-autoplay">
<div class="it-single-slide-wrapper">
<div class="card-wrapper">
<div class="card card-img">
<div class="img-responsive-wrapper">
<div class="img-responsive">
<div class="img-wrapper">
<img src="/bootstrap-lombardia/dist/assets/img/bike-sharing.jpg" title="bike sharing" alt="parcheggio bike sharing a Milano">
</div>
</div>
</div>
</div>
</div>
</div>
. . .
. . .
</div>
</div>In questo esempio sono state usate in particolare:
- sul div del contenitore delle card le classi
it-img-cardper la gestione di card immagineit-big-imgper ottenere una dimensione grande delle immaginiit25-carousel-autoplayper attivare lo scorrimento automatico delle immagini.
- su tutti i div di classe card-wrapper un ulteriore div con le classi
cardecard-imgper la formattazione delle singole card immagine
E’ da notare che le immagini vengono tagliate e riproporzionate automaticamente in modo da avere tutte le stesse dimensioni.
Immagini standard
<div class="bd-example">
<div class="it-carousel-wrapper it-carousel-landscape-abstract-three-cols">
<div class="it-carousel-all owl-carousel it-img-card it-standard-image it25-carousel-nav">
include esempi-lombardia/slides.html
</div>
</div>
</div>In questo esempio, rispetto al precedente, sono state usate, sul div del contenitore delle card, le classi:
it-standard-imageche dà dimensioni inferiori alle immagini, consentendo, su schermi grandi, di vederne 3 alla volta.it25-carousel-navche fa apparire le frecce di avanzamento/ritorno.
Si noti che i punti sotto le slide, su schermi grandi, sono solo 2, ed ognuno scorre 3 immagini alla volta, così come le frecce.
Su schermi piccoli invece i punti diventano 6, e come le frecce, scorrono una sola immagine alla volta.
Sfondo Immagine
Titolo del Carousel
<style>
.owl-dots {
background-color: #fff;
}
</style>
<div class="it-carousel-wrapper it-carousel-landscape-abstract-three-cols">
. . .
<div class="it-carousel-all owl-carousel it-card-bg"
style='background-image: url("/bootstrap-lombardia/dist/assets/img/bike-sharing.jpg");
background-size: cover;'>
. . . Rispetto al precedente esempio Titolo e Card qui è stato aggiunto:
- una
background-imagesul div contenitore delle card - uno sfondo bianco per la classe
owl-dotsche caratterizza il div che contiene i punti cliccabili. Quest’ultimo div tra l’altro, non va specificato nel codice HTML, perché viene automaticamente aggiunto via Javascript da Bootstrap Regione Lombardia.
Si noti che nonostante le dimensioni delle card siano tra loro anche molto differenti, il carousel riesce a gestirle rimanendo stabile.
Schema riepilogativo
Questo schema cerca di evidenziare ordinatamente le classi utilizzate in questi esempi e le combinazioni valide.
Il criterio secondo cui è stato scritto è il seguente:
- le classi sono identate come i div cui vanno associate
- per il contenitore delle immagini ogni riga mostra una delle combinazioni possibili
// Contenitore principale
it-carousel-wrapper + it-carousel-landscape-abstract-three-cols
// Titolo (facoltativo)
it-header-block
it-header-block-title
// Contenitore delle card o immagini
it-carousel-all + owl-carousel
" " + it-card-bg
" " + it-img-card
" " + " + it-big-img
" " + " + it-standard-image
// utilizzabili indipendentemente
" " + it25-carousel-nav
" " + it25-carousel-autoplay
// Uno per ogni card o immagine
it-single-slide-wrapper
card-wrapper
" + card-space
Riferimenti
Il contenuto di questa pagina si riferisce ai seguenti punti della Documentazione di Bootstrap Italia:
Card speciali
Nei carousel, le Card speciali, mostrate nella Documentazione di Bootstrap Italia, NON VANNO UTILIZZATE.


