Tekst źródłowy strony Szablon:Ambox/opis

{{Podstrona dokumentacji}}
<!-- EDYTUJ DOKUMENTACJĘ SZABLONU PONIŻEJ TEJ LINII -->
{{Mainsec|Wikipedia:Szablony komunikatów|Artykuły}}
{{Wysokie ryzyko|częste użycie|liczba=ponad 45 000}}
{{Szablony komunikatów}}
{{spis treści}}
To jest <nowiki>{{</nowiki>'''Ambox'''<nowiki>}}</nowiki> (skrót od '''''a'''rticle '''m'''essage '''box''''') — szablon szablonów.

Szablon ten jest używany do tworzenia komunikatów stosowanych w artykułach (przestrzeni głównej), takich jak {{S|Dopracować}}. Oferuje on różne kolory i obrazki, odpowiednie do rodzaju problemu wskazywanego przez tworzony komunikat.

== Użycie ==
Proste użycie:

<pre>
{{ambox
| tekst = Jakiś tekst.
}}
</pre>

{{ambox
| tekst = Jakiś tekst.
}}

Złożone użycie:

<pre>
{{ambox
| typ     = zawartość
| tekst   = Tekst wiadomości.
}}
</pre>

{{ambox
| typ     = zawartość
| tekst   = Tekst wiadomości.
}}

== Opis parametrów ==
Lista opisanych parametrów (nieopisane są dwa parametry: ''style'' i  ''nomobile''):

<pre>
{{ambox
| typ     = poważny / zawartość / integruj / wiadomość
| grafika = brak / nie / {{ikona|jakaś ikona|35}}
| grafika prawo = {{ikona|jakaś ikona|35}} / w ostateczności [[Plik:Jakaś grafika|35px]]
| tekst   = Tekst szablonu
}}
</pre>

=== ''typ'' ===
{{mainsec|Wikipedia:Szablony komunikatów|Odmiany kolorystyczne szablonów mbox|Odmiany kolorystyczne}}
Parametr ''typ'' definiuje kolor lewego paska szablonu oraz domyślną ikonę. Typ nie powinien być wybierany ze względów estetycznych, ale powinien być wybierany w zależności od przedstawianego przez komunikat problemu. Dostępne są 4 typy, które przedstawiono poniżej z domyślnymi ikonami.

{{ambox
| typ   = poważny
| tekst = typ=<u>poważny</u> – Poważne problemy, jak {{S|DNU}} i {{S|NPA}}.
}}
{{ambox
| typ   = zawartość
| tekst = typ=<u>zawartość</u> – Problemy z zawartością, jak {{S|Dopracować|POV}}.
}}
{{ambox
| typ   = wiadomość
| tekst = typ=<u>wiadomość</u> – informacje o artykule, jak {{S|Aktualne}} i {{S|W edycji}}. 
}}
{{ambox
| typ   = integruj
| tekst = typ=<u>integruj</u> – integracja, dzielenie i propozycje transwiki, jak {{S|Integracja}}.
}}

Jeśli w wywołaniu szablonu nie zadeklarowano parametru ''typ'', domyślnym ustawieniem jest {{Parametr|typ|wiadomość}}.

=== ''grafika'' ===
: '''''jakaś grafika''''' = Powinien zostać użyty szablon {{s|ikona}} z szerokością 35px. Na przykład:
::<code><nowiki>{{ikona|pov|35}}</nowiki></code>

{{ambox
| typ  = zawartość
| grafika = {{ikona|pov|35}}
| tekst = typ = zawartość <br /> grafika = <nowiki>{{ikona|pov|35}}</nowiki> <br /> Ta grafika jest używana w szablonie {{S|Dopracować|POV}} i podobnych.
}}
{{ambox
| typ  = integruj
| grafika = {{ikona|integracja|35}}
| tekst = typ = integruj <br /> grafika = <nowiki>{{ikona|integracja|35}}</nowiki> <br /> Ta grafika jest używana w {{S|Integracja}}, itp.
}}

Jeśli ten parametr nie jestr określony, używana jest domyślna grafika związana z parametrem '''typ''' (zobacz domyślne obrazki w sekcji [[#typ]] powyżej).

Jeśli jako parametr podano {{Parametr|grafika|nie}}, w szablonie nie jest używana grafika, a tekst jest wyrównany do lewej bez pozostawienia pustego miejsca. Jeśli natomiast jako parametr podano {{Parametr|grafika|brak}}, szablon nie używa żadnej grafiki, ale zostawia puste pole szerokości domyślnego obrazka, co pozwala na wyrównywanie tekstu w kilku szablonach.

{{ambox
| grafika = brak
| tekst  = Brak typu i '''grafika=brak''' – Czyści pole i zostawia margines szerokości domyślnej grafiki. Pozwala na ładne łączenie tekstu z różnych szablonów.
}}
{{ambox
| grafika = nie
| tekst  = Brak typu i '''grafika=nie''' – Nie jest użyta żadna grafika, a '''tekst''' wykorzystuje całą szerokość pola.
}}

{{ambox
| grafika = {{ikona|aktualne|35}}
| grafika prawo = {{ikona|biblioteka|35}}
| tekst  = grafika = <nowiki>{{ikona|aktualne|35}}</nowiki> <br /> grafika prawo = <nowiki>{{ikona|biblioteka|35}}</nowiki>
}}

{{ambox
| tekst  = grafika prawo = <nowiki>{{skrót|id=stary|WP:SK}}</nowiki> <br /> Szablony skrótów umieszczaj w '''grafika prawo''', bo inaczej popsują wygląd szablonu.
| grafika prawo = {{skrót|id=stary|WP:SK}}
}}

=== ''grafika prawo'' ===
Po prawej stronie szablonu można umieścić drugą grafikę lub inny obiekt, wprowadzając jego kod jako parametr {{Parametr|grafika prawo}}.

Jeśli nie zdefiniowano tego parametru, szablon nie wyświetla żadnej grafiki lub elementu po prawej stronie komunikatu.

=== ''tekst'' ===
Tekst szablonu, lub inne elementy jego zawartości.

== Szczególne przypadki ==
Jeśli masz zamiar wykorzystywać znaki specjalne w parametrze '''tekst''', musisz zastosować poniższe rozwiązania: 

<pre>
{{ambox
| tekst  = <div>
Znak równości = i klamerki { } działają dobrze bez żadnych niepotrzebnych zabiegów.
Ale oto idzie linia prosta {{!}} i dwie zamykające klamerki &lt;nowiki>}}&lt;/nowiki>. 
A teraz zarówno linia prosta, jak i klamerki: &lt;nowiki>|}}&lt;/nowiki>.
</div>
}}
</pre>

{{ambox
| tekst  = <div>
Znak równości = i klamerki { } działają dobrze bez żadnych niepotrzebnych zabiegów.
Ale oto idzie linia prosta {{!}} i dwie zamykające klamerki <nowiki>}}</nowiki>. 
A teraz zarówno linia prosta, jak i klamerki: <nowiki>|}}</nowiki>.
</div>
}}

Ten szablon korzysta z klas CSS, więc łatwo można go zmienić według preferencji użytkowników.

Klasy CSS mogą być użyte także bezpośrednio w tabelkach:

<pre>
{| class="ambox ambox-content"
|-
| class="ambox-image" | {{ikona|pomuwaga|35}}
| Jakiś tekst
|}
</pre>

{| class="ambox ambox-content"
|-
| class="ambox-image" | {{ikona|pomuwaga|35}}
| Jakiś tekst
|}

Ten szablon korzysta ze znaczników HTML, a nie z wikitekstu. To normalna droga tworzenia szablonów dla szablonów, ponieważ wikitekst ma kilka problemów. Na przykład trudniej jest przy nim używać [[mw:Help:Extension:ParserFunctions|funkcji parsera]] i znaków specjalnych w parametrach.
== Parametry szablonu ([[Pomoc:Jak dodać TemplateData|strukturyzacja VE]]) ==
<templatedata>
{
"params": {
"styl": {
"label": "Styl"
},
"typ": {
"label": "Typ",
"suggested": true
},
"grafika": {
"label": "Grafika",
"example": "{{ikona|pov|35}}",
"suggested": true
},
"tekst": {
"label": "Tekst",
"required": true,
"suggested": true
},
"grafika prawo": {
"label": "Dodatkowa grafika"
}
},
"paramOrder": [
"tekst",
"typ",
"grafika",
"grafika prawo",
"styl"
],
"format": "block"
}
</templatedata>

== Zobacz też ==
* {{s|Tmbox}}, odpowiednik dla stron dyskusji.
* {{s|Fmbox}}, odpowiednik dla komunikatów systemowych.
* {{s|Ombox}}, odpowiednik dla pozostałych przestrzeni nazw.
* {{s|Dmbox}}, szablon dla komunikatów o ujednoznacznieniach i przekierowaniach.
* {{s|Mbox}}, szablon dla komunikatów wykorzystywanych w różnych [[Pomoc:Przestrzeń nazw|przestrzeniach nazw]], automatycznie wybiera odpowiedni szablon komunikatów.

Inne strony:
* '''[[Wikipedia:Szablony komunikatów]]''' – metastrona omawiająca zasady stosowania szablonów komunikatów.

<includeonly>
[[Kategoria:Szablony komunikatów mbox|{{PAGENAME}}]]
</includeonly>