--=REKLAMA=--

Szablon

Ambox

Z Joomla!WikiPL

[ przeglądaj][edytuj][historia] Szablon:Ambox - dokumentacja

To jest szablon {{ambox}} (skrót od article message box).

{{ambox}} jest szablonem stosowanym w wielu blokach (ramkach) informacyjnych, umieszczanych zwykle w górnej części artykułu. Szablon generuje dwukolumnową tabelę z opcjonalną "ikoną wiadomości". Tekst wiadomości musi być ustalony w szablonie wywołującym w parametrze {{{tekst}}}.

Szablonu {{ambox}} nigdy nie należy stosować bezpośrednio, a tylko przez szablony pośredniczące, takie jak {{Uwaga}}, {{Definicja}}, {{dopracować}}, czy innych szablonów znaczników. Te szablony zapewniają dzięki parametrom spójny wygląd (kolorowanie i obrazki odpowiednie do rodzaju problemu) i standardowe wiadomości oraz umieszczają w artykule, w którym są wykorzystane, znaczniki kategorii.

Stosowanie

Proste użycie: {{ambox|tekst=Jakiś tekst.}}


Złożone użycie:

{{ambox
| typ  = styl
| grafika = [[Grafika:Wikitekst.png|50px]]
| tekst  = Tekst wiadomości.
| grafikapoprawej = [[Grafika:Nuvola apps bookcase.png|40px]]
}}

Domyślne obrazki

Poniższe przykłady pokazują użycie różnych wartości dla argumentu type, bez użycia parametru obrazka.

Inne grafiki

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

Specjały

Przykłady innych kombinacji parametrów.

Parametry

Lista wszystkich parametrów:

{{ambox
| typ     = poważny / zawartość / styl / integruj / wiadomość
| grafika = brak / nie / {{ikona|gwiazdkapm|35}}
| grafikapoprawej = {{ikona|gwiazdkapm|35}}
| tekst   = Tekst wyświetlanego komunikatu, treść szablonu
}}

typ

Jeśli nie podano parametru typ, stosowany jest typ uwaga.

grafika

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. Na przykład:
[[Grafika:Unbalanced scales.png|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-"specjały" powyżej)

grafikapoprawej

Brak parametru = Nie wyświetla grafiki po prawej
Jakaś grafika = Jak wyżej. Na przykład:
[[Grafika:Nuvola apps bookcase.png|40px]]
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 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.png|40px]]
| Jakiś tekst
|}
Emblem-important.png 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.