Szablon:Ambox/opis

To jest podstrona dokumentacji dla strony Szablon:Ambox. Zawiera ona informacje na temat użycia tej strony, jej kategoryzację i inną zawartość niebędącą częścią oryginalnej strony.

To jest Ambox (skrót od article message box) - szablon szablonów.

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

Użycie

Proste użycie

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

Złożone użycie

{{Ambox
| typ     = styl
| grafika = [[Grafika:Wikitext.svg|50px]]
| 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.

Inne grafiki

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

Specjały

Przykłady innych kombinacji parametrów.

Parametry

Lista wszystkich parametrów:

{{Ambox
| typ           = poważny / zawartość / styl / integruj / wiadomość
| grafika       = brak / nie / [[Grafika:Jakaś grafika.svg|40px]]
| grafika prawo = [[Grafika:Jakaś grafika.svg|40px]]
| tekst         = Tekst szablonu
}}

Uwaga: Jedynym wymaganym parametrem jest tekst.

Parametry Ambox
typ (opcjonalny)	Typ powiadomienia. Jeśli nie podano parametru typ, przyznawany jest typ wiadomość. Szablon otrzymuje jasnoniebieski pasek po lewej.
grafika (opcjonalny)	Ikona komunikatu. Brak parametru - używana jest domyślna grafika związana z parametrem typ. Jakaś grafika - użyta szerokość powinna mieścić się w granicach 40-50px. Przykładowo: [[Grafika:Unbalanced scales.svg|40px]] 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 powyżej).
grafika prawo (opcjonalny)	Ikona komunikatu. Brak parametru - nie wyświetla grafiki po prawej. Jakaś grafika - jak wyżej. Przykładowo: [[Grafika:Nuvola apps bookcase.png|40px]] Cokolwiek - dowolny obiekt, który chcesz po prawej stronie.
tekst (wymagany)	Treść komunikatu.

Szczegóły techniczne

Jeśli masz zamiar wykorzystywać znaki specjalne w parametrze tekst, musisz je wyescape'ować:

{{Ambox
| tekst  = <div>
Znak równości = i klamerki { } działają dobrze bez żadnych niepotrzebnych zabiegów.
Ale oto idzie linia prosta {{!}} i dwie zmykają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:

{| class="ambox ambox-content"
|-
| class="ambox-image" | [[Grafika:Emblem-important.svg|40px]]
| Jakiś tekst
|}

Ten szablon korzysta ze znaczników HTML, a nie z wikitekstu. To normalna droga robienia szablonów dla szablonów, ponieważ wikitekst ma kilka problemów. Na przykład trudniej jest przy nim używać funkcji parsera i znaków specjalnych w parametrach.

Zobacz też

• {{Fmbox}}