Questa pagina è protetta dallo spostamento
Questa pagina è protetta

Template:Cassetto

Da Wikipedia, l'enciclopedia libera.
Jump to navigation Jump to search


Template protetto – Le modifiche possono essere proposte nella pagina di discussione.
Info Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Cassetto/man (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, 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

(legenda colori)

{{cassetto
|titolo = <!-- titolo del riquadro -->
|testo = <!-- testo contenuto -->
|larghezza = <!-- larghezza del riquadro -->
|livello = <!-- numero del livello della sezione -->
|colore = <!-- colore dello sfondo -->
|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 viene inserito inizialmente aperto, anziché inizialmente chiuso. Inserire "si" o lasciare vuoto.
  1. ^ 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 è illustrato in questo esempio:

{{Cassetto|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}

Che produce questo risultato:

Titolo del riquadro

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:

Titolo del riquadro

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...
}}
Titolo del riquadro

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:

Apri il cassetto per vedere il testo...
...chiudi il cassetto per nascondere il testo.

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

...chiudi il cassetto per nascondere il testo.

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

template Progetto Template: collabora a Wikipedia sull'argomento template

VisualEditor 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.

Parametri template

ParametroDescrizioneTipoStato
Titolo (obbligatorio)titolo

Il titolo che deve apparire nella cornice superiore

Stringaobbligatorio
Testo (obbligatorio)testo

Inserire il contenuto visualizzato quando il cassetto è aperto, può benissimo contenere testo formattato secondo le convenzioni di Wikipedia

Stringaobbligatorio
Larghezzalarghezza

La larghezza del riquadro espressa in pixel o in percentuale; se non espresso assume la larghezza della pagina. Esempio: 100px oppure 50%

Stringafacoltativo
Livellolivello

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.

Stringafacoltativo
Colore intestazionecolore

Colore di sfondo del rettangolo che contiene il titolo, in esadecimale. Esempio: #FF0000 (rosso).

Stringafacoltativo
Colore sfondocoloresfondo

Colore di sfondo della parte visibile quando la finestra è aperta, in esadecimale. Esempio: #FFFF00 (giallo).

Stringafacoltativo
Allineamentoallineamento

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.

Stringafacoltativo
Allineamentoaffiancabile

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.

Stringafacoltativo
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.

Stringafacoltativo