{{Dipendenze Lua|Message box}}
{{Dipendenze CSS|pref=Template:|Mbox/common.css,Imbox/styles.css}}

Questo è {{Tl|Imbox}} (['''I''']mage ['''m''']essage ['''box''']) metatemplate.

Viene usato per costruire i messaggi di avviso per le pagine dei file (immagini), come ad esempio {{Tl|GFDL}} ecc. Prevede differenti colori utilizzabili, ha un'immagine di default (se non viene indicata una differente) e offre altre caratteristiche.

Funziona esattamente come {{Tl|Ambox}} e prevede gli stessi parametri.

=== Uso ===
;L'uso più semplice è questo:
<pre>
{{Imbox | testo = Lorem ipsum}}
</pre>

{{Imbox | testo = Lorem ipsum}}


;Un esempio più complesso:
<pre>
{{Imbox
| tipo       = stile
| immagine   = [[File:Emblem-question-yellow.svg|40px]]
| stile      = width: 400px;
| stiletesto = color: red; font-weight: bold; font-stile: italic;
| testo      = Il testo del messaggio
}}
</pre>

{{Imbox
| tipo       = stile
| immagine   = [[File:Emblem-question-yellow.svg|40px]]
| stile      = width: 400px;
| stiletesto = color: red; font-weight: bold; font-stile: italic;
| testo      = Il testo del messaggio
}}

=== Tipi di avvisi per le immagini ===
Gli esempi che seguono usano differenti parametri per ''tipo'' ma non specificano nessun parametro per l'immagine. In questo modo mostrano l'immagine di default prevista per ciascun tipo.

{{Imbox
| tipo = immediata
| testo = tipo=<u>immediata</u> – Template di cancellazione immediata.
}}

{{Imbox
| tipo = cancella
| testo = tipo=<u>cancella</u> – Template di cancellazione.
}}

{{Imbox
| tipo = contenuto
| testo = tipo=<u>contenuto</u> – Principali avvisi e problemi.
}}

{{Imbox
| tipo = stile
| testo = tipo=<u>stile</u> –  Avvisi e problemi minori.
}}

{{Imbox
| tipo = avviso
| testo = tipo=<u>avviso</u> – Messaggi di avviso di qualsiasi tipo, permanenti o temporanei.
}}

{{Imbox
| tipo = esempio
| testo = tipo=<u>esempio</u> – Template per gli esempi e suggerimenti
}}

{{Imbox
| tipo = sposta
| testo = tipo=<u>sposta</u> – Messaggi che richiedono spostamenti, unioni, divisioni e proposte.
}}

{{Imbox
| tipo = protezione
| testo = tipo=<u>protezione</u> – Template di protezione, quando mostrati in un file.
}}

{{Imbox
| tipo = featured
| testo = tipo=<u>featured</u> – Template per immagini in evidenza.
}}

{{Imbox
| tipo = licenza
| testo = tipo=<u>licenza</u> – Template da apporre per le licenze dei file.
}}

{{Imbox
| tipo = altro
| testo = tipo=<u>altro</u> – Template per altri casi che non rientrano nei precedenti.
}}

=== Speciali ===
Altre combinazioni di parametri.

{{Imbox
| testo = Nessun tipo e nessuna immagina ('''default''')
}}

{{Imbox
| immagine = none
| testo = Nessun ''tipo'', '''immagine = none''' – Nessuna immagine usata e il  '''testo''' prende tutto lo spazio disponibile.
}}

{{Imbox
| tipo = licenza
| immagine = [[File:PD-icon.svg|40px]]<br/>[[File:Ambox warning yellow.svg|40px]]
| immaginedestra = [[File:Shuttle.svg|30px]]
| testo = tipo = licenza<br/>image = <nowiki>[[File:PD-icon.svg|40px]]&lt;br/>[[File:Ambox warning yellow.svg|40px]]</nowiki><br/> immaginedestra = <nowiki>[[File:Shuttle.svg|30px]]</nowiki>
}}

{{Imbox
| tipo = licenza
| immagine = [[File:PD-icon.svg|40px]]<br/>[[File:Ambox warning yellow.svg|40px]]
| immaginedestra = [[File:Shuttle.svg|30px]]
| testo = '''Questo file è nel pubblico domino perché è stato creato dalla [[W:NASA|NASA]].'''<br/>Si noti che l'uso di loghi, insegne ed emblemi della NASA è limitato dalla legge statunitense.
}}

{{Imbox
| tipo = licenza
| immagine = [[File:PD-icon.svg|40px]]
| testo =
tipo = licenza<br/>immagine = <nowiki>[[File:PD-icon.svg|40px]]</nowiki><br/>sotto = <nowiki>{{Imbox |tipo=contenuto |testo='''Questa licenza è deprecata!'''}}</nowiki>
| sotto = {{Imbox |tipo=contenuto |testo='''Questa licenza è deprecata!'''}}
}}

=== Altre immagini===
Le immagini predefinite mostrate sopra sono principalmente per comodità. In molti casi è più appropriato usare immagini più specifiche. Questi esempi usano il parametro '''immagini''' per specificare un'immagine diversa da quella predefinita.

<!-- NON CI SONO TROPPI PROBLEMI DI IMMAGINI QUI, LO TENGO PER FUTURA MEMORIA
{{Imbox
| tipo = stile
| image = [[File:Gnome-dev-camera.svg|42px]]
| text = tipo = stile<br/>immagine = <nowiki>[[File:Gnome-dev-camera.svg|42px]]</nowiki><br/>This image is used for {{Tl|cleanup-image}}.
}}
{{Imbox
| tipo = sposta
| image = [[File:To Commons.svg|52px]]
| text = tipo = sposta<br/>immagine = <nowiki>[[File:To Commons.svg|52px]]</nowiki><br/>This image is used for {{Tl|copy to Wikimedia Commons}}.
}} -->
{{Imbox
| tipo = licenza
| image = [[File:Heckert GNU white.svg|48px]]
| text = tipo = licenza<br/>image = <nowiki>[[File:Heckert GNU white.svg|48px]]</nowiki><br/>Questa immagine è usata per template riguardanti la licenza GFDL come ad esempio {{Tl|GFDL}}.
}}

== Parametri ==
Lista di tutti i parametri
<pre>
{{Imbox
| tipo  = immediata / cancella / contenuto / stile / sposta / avviso / 
          protezione / licenza / featured / altro / esempio
| immagine = none / [[File:Some immagine.svg|40px]]
| immaginedestra = [[File:Some immagine.svg|40px]]
| stile = un valore CSS
| stiletesto = un valore CSS
| plainlinks  = no
| testo  = Il testo da visualizzare all'interno del messaggio.
| below = Altro testo in un altro Imbox.
}}
</pre>

; ''tipo''
:Se il parametro '''tipo''' non viene dato, il template imposta di default '''avviso'''. Si avrà quindi uno sfondo blu.

; immagine
:'''Nessun parametro''' = se il parametro '''immagine''' non è dato, il template usa l'immagine di default, che dipende dal parametro '''tipo''' che si è impostato.
:'''Un'immagine''' = dovrebbe essere un'immagine inserita con il solito wikitesto. Solitamente ha una larghezza di 40px - 50px con allineamento a destra, ma dipende dal rapporto height-to-width (manualmente si può comunque inserire qualsiasi larghezza).
::Per esempio: <code><nowiki>immagine = [[File:Sub-arrows.svg|40px]]</nowiki></code>
:'''none''' = significa che non è stata usata nessuna immagine.

; immaginedestra
:'''Nessun parametro''' = se nessun parametro '''immaginedestra''' è dato, nessuna immagine sarà mostrata sul lato destro.
:'''Un'immagine''' = dovrebbe essere un'immagine con un significato immediatamente riconoscibile. Solitamente ha una larghezza di 40px - 50px con allineamento a destra, ma dipende dal rapporto height-to-width (manualmente si può comunque inserire qualsiasi larghezza).
::Per esempio: <code><nowiki>immaginedestra = [[File:Nuvola apps bookcase.svg|40px]]</nowiki></code>
:'''Anything''' = Qualsiasi altro oggetto vuoi che sia mostrato sul lato destro.

; stile
:Un [[w:Cascading stile Sheets|CSS]] usato per l'intero box di avviso. Non necessità delle virgolette <code>" "</code> ma con la semi colonna finale <code>;</code>.
::For example: <code>stile = margin-bottom: 0.5em;</code>

; stiletesto
:Un [[w:Cascading stile Sheets|CSS]] opzionale usato dalla casella di testo.
::Per esempio: <code>stiletesto = text-align: center;</code>

; plainlinks
:Normalmente, su Wikizionario i link esterni sono segnalati da una piccola freccia, come qui: [http://www.example.com Example.com]. Nei box degli avvisi questa freccia è soppressa di default, come qui: <span class="plainlinks">[http://www.example.com Example.com]</span>. Per avere lo stile normale previsto per i link esterni, usa <code>|plainlinks=no</code>.

; testo
:Il testo del messaggio.

; sotto
:Un'area a larghezza intera al di sotto delle immagini e dell'area di testo. Può essere un'aerea di testo o qualsiasi altro tipo, per esempio un altro Imbox:
::<code><nowiki>below = {{Imbox |tipo=contenuto |testo='''Questa licenza è deprecata!'''}}</nowiki></code>

; plainlinks
:Attivato di default. Se vogliamo mostrare la freccia dei link esterni - [[File:External.svg|10px]], specificare:
::<code><nowiki>plainlinks = no</nowiki></code>

=== Dettagli tecnici ===
Il namespace "File:" è stato rinominato in questo modo l'11 Dicembre 2008. Questo template è stato originariamente creato prima di tale data, è per questo che si chiama "imbox" da "image message box".

<pre>
{{Imbox
| testo  = <div>
Il segno uguale = e le parentesi graffe, sia aperte che chiuse { }  funzionano bene così come sono.
Ma ecco un pipe {{!}} e due parentesi graffe chiuse &lt;nowiki>}}&lt;/nowiki>.
Ed ora un pipe e due parentesi graffe chiuse &lt;nowiki>|}}&lt;/nowiki>.
</div>
}}
</pre>

{{Imbox
| testo  = <div>
Il segno uguale = e le parentesi graffe, sia aperte che chiuse { }  funzionano bene così come sono.
Ma ecco un pipe {{!}} e due parentesi graffe chiuse <nowiki>}}</nowiki>.
Ed ora un pipe e due parentesi graffe chiuse <nowiki>|}}</nowiki>.
</div>
}}


* Questo template usa classi CSS contenute nella sottopagina [[Template:Imbox/styles.css]] (oltre che in [[Template:Mbox/common.css]] per la parte comune ai template "box"), quindi è totalmente personabilizzabile
* Al suo interno questo metatemplate usa codice HTML invece che il markup wiki per le tabelle. Questo perché nei metatemplate il markup wiki presenta alcuni inconvenienti. Per esempio rende più difficile usare le funzioni parser e i caratteri speciali nei parametri. 
* Le immagini di default di questo metatemplate sono in formato PNG invece che in SVG. La ragione principale è che alcuni browser più datati hanno problemi con lo sfondo trasparente che genera Mediawiki con le immagini SVG. Le immagini PNG qui usate sono ottimizzate in modo da essere visualizzate correttamente su qualunque browser. Si noti che le SVG sembrano solo peggiori con i vecchi browser, così vale la pena fare l'ottimizzazione per le icone più utilizzate.

<noinclude>[[Categoria:Manuali dei template|Imbox]]</noinclude>