Template:Cassetto
Istruzioni per l'usoLe istruzioni che seguono sono contenute nella sottopagina Template:Cassetto/man (modifica · cronologia)
Sandbox: Template:Cassetto/Sandbox (modifica · cronologia) · TemplateStyles: Template:Cassetto/styles.css (modifica · cronologia) · Tutte le sottopagine: lista
Questo template è utilizzato per creare i cosiddetti "cassettamenti", ovvero delle sezioni a scomparsa per migliorare la fruibilità e l'ordine di alcune pagine, in casi particolari. L'uso dei cassetti nelle voci è sconsigliato (v. disc.1, disc.2), pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o altre pagine di servizio.
Nelle voci i cassetti dovrebbero essere limitati ai template di navigazione (realizzati generalmente non con il template Cassetto, ma con il template:Navbox), che non fanno parte del contenuto enciclopedico. Il motivo è che i cassetti danno problemi di accessibilità, non funzionano nella stampa, fanno sembrare la pagina più leggera ma in realtà appesantiscono il download, tolgono ingiustamente rilievo. Se l'informazione è enciclopedica ha tutto il diritto di prendere il necessario spazio, mentre se la vogliamo "nascondere" forse non è così enciclopedica. Se una pagina diviene pesante, pensare piuttosto a uno scorporo; se si vuol risparmiare spazio, sfruttare meglio le sezioni o le colonne.
Sintassi
{{cassetto
|titolo = <!-- titolo del riquadro -->
|testo = <!-- testo contenuto -->
|larghezza = <!-- larghezza del riquadro -->
|livello = <!-- numero del livello della sezione -->
|colore = <!-- colore dello sfondo del titolo -->
|coloresfondo = <!-- colore dello sfondo del cassetto aperto -->
|allineamento = <!-- destra o sinistra -->
|affiancabile = <!-- "si" o lasciare vuoto -->
|senzabordo = <!-- "si" o lasciare vuoto -->
|aperto = <!-- "si" o lasciare vuoto -->
}}
- titolo[1]
- obbligatorio. il titolo che deve apparire nella cornice superiore
- testo[1]
- obbligatorio. il contenuto visualizzato quando il cassetto è aperto, può benissimo contenere testo formattato secondo le convenzioni di Wikipedia
- larghezza=
- La larghezza del riquadro espressa in pixel o in percentuale; se non espresso assume la larghezza della pagina
- Pixel. Assumerà la dimensione pari al numero di pixel indicati; la cifra va fatto seguire da "px", es. 10px
- percentuale. la larghezza varierà a secondo della larghezza della pagina secondo la percentuale indicata la cifra va fatta seguire da "%", es. 30%
- livello=
- Serve per far sì che il cassetto appaia nell'indice come se fosse una sezione. Il livello di sezione va indicato scrivendo il numero di "=" che è necessario mettere davanti al titolo della sezione per ottenere quel livello normalmente in wikipedia (ad esempio == Intestazione == corrisponderà a livello=2). Nota: non ha alcun effetto grafico sul cassetto stesso.
- colore=
- Il colore dello sfondo del rettangolo che contiene il titolo, indicato con questi codici.
- coloresfondo=
- Il colore di fondo della parte visibile quando la finestra è aperta, indicato con questi codici.
- allineamento=
- Indica la posizione del template rispetto la pagina, può assumere solo due valori: destra o sinistra; se non specificato il template viene visualizzato al centro.
- affiancabile=
- Rende il riquadro affiancabile da altri riquadri (div) circostanti, come ad esempio il babelbox. È utile quando si vogliono integrare un cassetto con altri riquadri uno a fianco all'altro. Inserire "si" o lasciare vuoto.
- senzabordo=
- Elimina il bordo del riquadro per avere una continuità con la formattazione circostante. Si usa in situazioni complesse, ad esempio quando il cassetto fa parte di una struttura più grande. Inserire "si" o lasciare vuoto.
- aperto=
- Il cassetto appare normalmente chiuso. nel caso, invece, lo si voglia far apparire inizialmente aperto, inserire il campo lasciandolo vuoto oppure inserendo "si".
- ^ a b titolo e testo possono, a differenza degli altri parametri, anche non essere esplicitati; in questo caso basta scrivere {{cassetto|titolo|contenuto}}. Ricorda però che in alcuni casi, ad esempio per la presenza di un collegamento esterno, tale sistema NON funziona e il cassetto non si apre.
Esempi
L'utilizzo del template inizialmente chiuso è illustrato in questo esempio:
{{Cassetto|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}
Che produce questo risultato:
testo contenuto, con tutta la formattazione necessaria...
L'utilizzo del template inizialmente aperto è illustrato in questo esempio:
{{Cassetto|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
|aperto =
}}
Che produce questo risultato:
testo contenuto, con tutta la formattazione necessaria...
È possibile anche specificare la larghezza della barra del titolo con il parametro "larghezza":
{{Cassetto|larghezza=30%|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}
risultato:
testo contenuto, con tutta la formattazione necessaria...
Si può impostare l'allineamento, a destra o a sinistra, con il parametro "allineamento", in questo caso il riquadro diventa "flottante":
{{Cassetto|larghezza=30%|allineamento=destra|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}
testo contenuto, con tutta la formattazione necessaria...
Il risultato è qui a destra
Si possono anche utilizzare colori diversi per lo sfondo ed il testo del titolo:
{{Cassetto
|colore=red
|titolo={{colore|white|Apri il cassetto per vedere il testo...}}
|testo=...chiudi il cassetto per nascondere il testo.
}}
risultato:
Esempio del parametro livello; questo cassetto con livello=3 compare nell'indice a inizio pagina come se fosse una sezione (o meglio una sottosezione della sezione Esempi, che è di livello 2).
Esempio di cassetto-sezione
Note importanti
- L'inserimento di tabelle nel cassetto dà problemi a causa della presenza di "
|". Per risolverli usare {{cassetto inizio}}, oppure sostituire le | con {{!}}.
- Se il testo contiene degli "
=" (uguale), ad esempio titoli di sezione come== Titolo ==o URL complessi, la sintassi anonima non funziona. Esplicitare il parametro|testo=(oppure|2=).
Template correlati
- {{Cassetto inizio}}
- {{Cassetto fine}}
Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:Cassetto/TemplateData (modifica·cronologia)
Questo template è utilizzato per creare i cosiddetti cassettamenti, ovvero delle sezioni a scomparsa per migliorare la fruibilità e l'ordine di alcune pagine. L'uso dei cassetti nelle voci è sconsigliato pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o nelle altre pagine di servizio.
| Parametro | Descrizione | Tipo | Stato | |
|---|---|---|---|---|
| Titolo (obbligatorio) | titolo | Il titolo che deve apparire nella cornice superiore | Stringa | obbligatorio |
| Testo (obbligatorio) | testo | Inserire il contenuto visualizzato quando il cassetto è aperto, può benissimo contenere testo formattato secondo le convenzioni di Wikipedia | Stringa | obbligatorio |
| Larghezza | larghezza | La larghezza del riquadro espressa in pixel o in percentuale; se non espresso assume la larghezza della pagina. Esempio: 100px oppure 50% | Stringa | facoltativo |
| Livello | livello | Serve per specificare se si desidera che il cassetto sia una sezione o una sottosezione a sé nella pagina a quale livello di sezione corrisponde il titolo della finestra. | Stringa | facoltativo |
| Colore intestazione | colore | Colore di sfondo del rettangolo che contiene il titolo, in esadecimale. Esempio: #FF0000 (rosso). | Stringa | facoltativo |
| Colore sfondo | coloresfondo | Colore di sfondo della parte visibile quando la finestra è aperta, in esadecimale. Esempio: #FFFF00 (giallo). | Stringa | facoltativo |
| Allineamento | allineamento | Indica la posizione del template rispetto la pagina, può assumere solo due valori: 'destra' o 'sinistra'; se non specificato il template viene visualizzato al centro. | Stringa | facoltativo |
| Allineamento | affiancabile | Rende il riquadro affiancabile da altri riquadri (div) circostanti, come ad esempio il babelbox. È utile quando si vogliono integrare un cassetto con altri riquadri uno a fianco all'altro. Inserire 'si' o lasciare vuoto. | Stringa | facoltativo |
| Senza bordo? | senzabordo | Elimina il bordo del riquadro per avere una continuità con la formattazione circostante. Si usa in situazioni complesse, ad esempio quando il cassetto fa parte di una struttura più grande. Inserire 'si' o lasciare vuoto. | Stringa | facoltativo |