Modello:Cassetto/man

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.), pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o altre pagine di servizio.

Pe' ne sapé 'e cchiù, vide 'a paggena Aiuto:Manuale di stile#Cassetti.

Sintassi

(legenda colori)
{{cassetto |titolo =  |testo =  |larghezza =  |livello =  |colore =  |coloresfondo =  |allineamento =  |affiancabile =  }}

titolo*: obbligatorio. il titolo che deve apparire nella cornice superiore

testo*: 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 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. Il livello di sezione va indicato scrivendo il numero di uguali che è necessario mettere davanti al titolo della sezione per ottenere quel livello normalmente in wikipedia (ad esempio == Intestazione == corrisponderà a livello=2). Nota: inserire il livello o cambiarlo non ha alcun effetto grafico. Serve solo a strutturare meglio la pagina da un punto di vista logico.

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 affianco all'altro. Inserire "si" o lasciare vuoto

*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=<span style="color:white">Apri il cassetto per vedere il testo...</span>
|testo=...chiudi il cassetto per nascondere il testo.
}}

risultato:

Apri il cassetto per vedere il testo...

...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 {{!}}, oppure substare il Cassetto (vedi la sezione Istruzioni per il subst).

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=).

Istruzioni per il subst

Se desideri substare il template

Compila il template con i parametri desiderati, ma:
1. substando il template, ovvero scrivendolo nella forma {{subst:Cassetto|...}}.
2. omettendo di includere il testo che vuoi racchiudere nel cassetto e sostituendolo con un testo segnaposto, con il parametro |testo=segnaposto per esempio.
Salva la pagina e poi riaprila in modifica.
Troverai che il template {{Cassetto|...}} è stato sostituito da un codice misto di HTML e wikicode.
Ora si tratta di modificare questo codice:
1. substa le funzioni parser, ovvero sostituisci {{#ifexpr: e {{#switch: con {{subst:#ifexpr: e {{subst:#switch: — questa operazione può essere considerata facoltativa, ma è consigliabile, in quanto elimina del codice ormai inutile;
2. sostituisci segnaposto con il testo che vuoi racchiudere nel cassetto; è conveniente eseguire questa operazione dopo la precedente, per poter più immediatamente individuare le funzioni parser da substare.
Salva nuovamente per avere il codice definitivo.

Template correlati

Prugietto Template: collabora a Wikipedia sull'argomento template