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

{{Wysokie ryzyko|liczba=około 50 000}}
{{Podstrona dokumentacji}}
<!-- EDYTUJ DOKUMENTACJĘ SZABLONU PONIŻEJ TEJ LINII -->
{{Szablony szablonów}}
To jest '''ambox''' (skrót od '''article message box''') — szablon szablonów.

Szablon ten jest używany do tworzenia szablonów, takich jak {{S|Dopracować}}. Oferuje on kolorowania i obrazki odpowiednie do rodzaju problemu.

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

==== Domyślne obrazki ====
Poniższe przykłady pokazują użycie różnych wartości dla argumentu '''typ''', nie korzystając z parametru obrazka.

{{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   = integruj
| tekst = typ=<u>integruj</u> – integracja, dzielenie i propozycje transwiki, jak {{S|Integracja}}.
}}
{{ambox
| typ   = wiadomość
| tekst = typ=<u>wiadomość</u> – informacje o artykule, jak {{S|Aktualne}} i {{S|W edycji}}. 
}}

==== Inne grafiki ====
Domyślne grafiki w wielu przypadkach można zastąpić bardziej odpowiednimi. Poniższe przykłady pokazują użycie parametru '''grafika'''.

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

==== Specjały ====
Przykłady innych kombinacji parametrów.

{{ambox
| tekst  = Brak typu i grafiki ('''domyślne''')
}}
{{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
| grafika = {{ikona|aktualne|35}}
| grafika prawo = [[Plik:Shuttle.svg|20px]]
| tekst  = '''Ten artykuł opisuje aktualny [[lot kosmiczny]].'''
<br />Zawartość może się zmienić wraz z postępem misji.
}}

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

=== Parametry ===
Lista wszystkich parametrów:

<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'''
: Jeśli nie podano parametru '''typ''', przyznawany jest typ '''wiadomość'''. Szablon otrzymuje jasnoniebieski pasek po lewej.

'''grafika'''
: '''Brak parametru''' = Używana jest domyślna grafika związana z parametrem '''typ'''. 
: '''Jakaś grafika''' = Powinien zostać użyty szablon {{s|ikona}} z szerokością 35px. Na przykład:
::<code><nowiki>{{ikona|pov|35}}</nowiki></code>
: '''nie''' = Nie używa grafiki
: '''brak''' = Nie używa żadnej grafiki, ale zostawia puste pole szerokości domyślnego obrazka, co pozwala na wyrównywanie tekstu w kilku szablonach. (Zobacz przykłady-"[[#Specjały|specjały]]" powyżej)

'''grafika prawo'''
: '''Brak parametru''' = Nie wyświetla grafiki po prawej
: '''Jakaś grafika''' = Jak wyżej. Na przykład:
::<code><nowiki>{{ikona|pov|35}}</nowiki></code>
: '''Cokolwiek''' = Dowolny obiekt, który chcesz po prawej stronie.

'''tekst'''
: Tekst szablonu.

=== Szczegóły techniczne ===
Jeśli masz zamiar wykorzystywać znaki specjalne w parametrze '''tekst''', musisz zrobić tak: 

<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ć wg 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.

== Zobacz też ==
* {{s|tmbox}}
* {{s|fmbox}}
* {{s|ombox}}
<includeonly>
[[Kategoria:Szablony szablonów|{{PAGENAME}}]]
<!-- DODAJ INTERWIKI PONIŻEJ TEJ LINII -->
</includeonly>