Szablon:Ambox

 Dokumentacja szablonu [zobacz] [edytuj] [historia] []

To jest {{Ambox}} (skrót od article message box) — szablon szablonów.

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

Użycie

Proste użycie:

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

Złożone użycie:

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

Opis parametrów

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

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

typ

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.

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

grafika

jakaś grafika = Powinien zostać użyty szablon {{ikona}} z szerokością 35px. Na przykład:

{{ikona|pov|35}}

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

grafika prawo

Po prawej stronie szablonu można umieścić drugą grafikę lub inny obiekt, wprowadzając jego kod jako 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:

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

{| 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ć funkcji parsera i znaków specjalnych w parametrach.

Parametry szablonu (strukturyzacja VE)

<templatedata> { "params": { "styl": { "label": "Styl" }, "typ": { "label": "Typ", "suggested": true }, "grafika": { "label": "Grafika", "example": "", "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ż

• {{Tmbox}}, odpowiednik dla stron dyskusji.
• {{Fmbox}}, odpowiednik dla komunikatów systemowych.
• {{Ombox}}, odpowiednik dla pozostałych przestrzeni nazw.
• {{Dmbox}}, szablon dla komunikatów o ujednoznacznieniach i przekierowaniach.
• {{Mbox}}, szablon dla komunikatów wykorzystywanych w różnych przestrzeniach nazw, automatycznie wybiera odpowiedni szablon komunikatów.

Inne strony:

• Wikipedia:Szablony komunikatów – metastrona omawiająca zasady stosowania szablonów komunikatów.