Modello:Cassetto/man

'A Wikipedia.

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[cagna surgente]

(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 -->
}}

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[cagna surgente]

L'utilizzo del template è illustrato in questo esempio:

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

Che produce questo risultato:


È 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:


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

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:


Note importanti[cagna surgente]

  • 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[cagna surgente]

Se desideri substare il template

  1. 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.
  2. 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.
  3. Salva nuovamente per avere il codice definitivo.

Template correlati[cagna surgente]

template Prugietto Template: collabora a Wikipedia sull'argomento template