Szablon:Legenda/opis

To jest podstrona dokumentacji dla szablonu {{Legenda}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Użycie

Pokazuje legendę w postaci par – kolorowy kwadrat i przypisany temu kolorowi opis.

Opis parametrów

{{legenda|kolor|opis|ramka|w linii=tak|paski=kolor}}

Pozycyjne (numerowane)

kolor – kod koloru (parametr CSS; wyjaśnienie w sekcji kolory) kwadratu z opisem
opis – opis związany z kolorem wskazanym wyżej
ramka – parametry ramki ww. kwadratu (parametr CSS), wartość none powoduje niepokazywanie ramki

Kluczowe (nazwane)

w linii=tak – opcjonalny parametr, którego jakakolwiek wartość po znaku równości powoduje umieszczanie danej pary w tej samej linii co para poprzednia (dokładniej działanie tego parametru można zbadać w poniższych przykładach
paski=kolor - dodaje teksturę pasków - szczególnie przydatne dla osób mających zaburzenia widzenia; parametr kolor może przyjmować dowolne wartości CSS (jak w argumencie pozycyjnym)

Kolory

Jako parametr kolor można użyć dowolnej wartości CSS, w tym:
- transparent, czyli brak wartości
  - wbrew powszechnej praktyce, w CSS nie istnieje kolor none i nie chcąc korzystać z koloru tła, należy użyć wartości transparent
- nazwa koloru z listy kolorów HTML (np. teal)
- pełny kolor HTML (np. #fff69a)
- skrócony kolor HTML (np. #f01, który odpowiada kolorowi #ff0011)
- wartości RGB
  - RGB z wartościami liczbowymi (np. rgb(10,15,54))
  - RGB z wartościami procentowymi (od 0-100%; np. rgb(5%,20%,100%))
- wartości RGB z dodatkowym parametrem przeźroczystości (np. rgba(5%,20%,100%,30%)); parametr przeźroczystości może być zapisany jako:
  - wartość procentowa (0-100%)
  - wartość liczbowa (0-1), gdzie 0 to 0%, a 1 to 100%. Wartości pośrednie podajemy bez początkowego zera, np. .4, a nie 0.4
- HSL - odcień, nasycenie i barwa (np. hsl(20%,40%,11%), hsl(.3turn,40%,30%), hsl(-500deg,40%,30%)). Odcień może być podany:
  - w procentach (0-100%) lub w jednostkach kątowych (również jako liczba ujemna) - deg (stopnie kątowe), grad (grady), turn (pełne koło; tj. .25 oznacza 1/4 koła, 90° lub 100 gradów) oraz rad (radiany). Więcej informacji po angielsku oraz w formie graficznej
  - nasycenie i jasność muszą być podane w procentach
- HSL z przeźroczystością, np. (np. hsl(8%,18%,10%, 0.2), hsl(15deg,40%,30%, 20%)
  - pierwsze trzy wartości (barwa, nasycenie, jasność) stosuje się wg zasad zapisu HSL (patrz wyżej)
  - przeźroczystość stosuje się zgodnie z zasadami przeźroczystości dla RGB (patrz wyżej)
- [niezalecane, tzw. deprecated]] nazwa koloru odpowiadająca elementowi GUI (np. Scrollbar będzie miał kolor paska narzędzi zgodnego z ustawieniami systemu)

Opisy techniczne:

Skrócona wersja po polsku
Pełna wersja po angielsku
Skrócona wersja po polsku dla wartości atrybutu (pełniejszy opis, ale nie jest kompatybilny w 100%)

Przykłady użycia

1. Elementy legendy ułożone pionowo, dwa ostatnie z kwadratem koloru bez ramki

Kod	Wynik
{{legenda\|white\|Afryka}} {{legenda\|green\|Ameryki}} {{legenda\|blue\|Oceania}} {{legenda\|#ff0\|Europa\|none}} {{legenda\|#ff2800\|Azja\|none}}	Afryka Ameryki Oceania Europa Azja

2. Elementy legendy ułożone poziomo, pierwszy z kwadratem w ramce, pozostałe – bez ramki

Kod	Wynik
{{legenda\|white\|Afryka\|w linii=tak}} {{legenda\|green\|Ameryki\|\|w linii=tak}} {{legenda\|blue\|Oceania\|\|w linii=tak}} {{legenda\|#ff0\|Europa\|\|w linii=tak}} {{legenda\|#ff2800\|Azja\|none\|w linii=tak}}	Afryka Ameryki Oceania Europa Azja

3. Elementy z paskami

Kod	Wynik
{{legenda\|blue\|Tereny księstwa X}} {{legenda\|red\|Tereny księstwa Y}} {{legenda\|blue\|Tereny sporne\|paski=red}}	Tereny księstwa X Tereny księstwa Y Tereny sporne

Grupowanie elementów legendy

Lp.	Kod	Wynik
1.	{{legenda\|white\|zima\|\|w linii=tak}} {{legenda\|SpringGreen\|przedwiośnie\|\|w linii=tak}} {{legenda\|YellowGreen\|wiosna\|\|}} {{legenda\|#ff0\|lato\|\|w linii=tak}} {{legenda\|gold\|złota jesień\|\|w linii=tak}} {{legenda\|LightSalmon\|jesień\|none\|w linii=tak}}	zima przedwiośnie wiosna lato złota jesień jesień
2.	{{legenda\|white\|zima\|\|}} {{legenda\|SpringGreen\|przedwiośnie\|\|w linii=tak}} {{legenda\|YellowGreen\|wiosna\|\|}} {{legenda\|#ff0\|lato\|\|w linii=tak}} {{legenda\|gold\|złota jesień\|\|w linii=tak}} {{legenda\|LightSalmon\|jesień\|none\|w linii=tak}}	zima przedwiośnie wiosna lato złota jesień jesień
3.	{{legenda\|white\|zima\|\|}} {{legenda\|SpringGreen\|przedwiośnie\|\|}} {{legenda\|YellowGreen\|wiosna\|\|}} {{legenda\|#ff0\|lato\|\|w linii=tak}} {{legenda\|gold\|złota jesień\|\|w linii=tak}} {{legenda\|LightSalmon\|jesień\|none\|w linii=tak}}	zima przedwiośnie wiosna lato złota jesień jesień
4.	{{legenda\|white\|zima\|\|}} {{legenda\|SpringGreen\|przedwiośnie\|\|w linii=tak}} {{legenda\|YellowGreen\|wiosna\|\|w linii=tak}} {{legenda\|#ff0\|lato\|\|}} {{legenda\|gold\|złota jesień\|\|w linii=tak}} {{legenda\|LightSalmon\|jesień\|none\|w linii=tak}}	zima przedwiośnie wiosna lato złota jesień jesień
5.	{{legenda\|white\|zima\|\|}} {{legenda\|SpringGreen\|przedwiośnie\|\|w linii=tak}} {{legenda\|YellowGreen\|wiosna\|\|w linii=tak}}<br /> {{legenda\|#ff0\|lato\|\|w linii=tak}} {{legenda\|gold\|złota jesień\|\|w linii=tak}} {{legenda\|LightSalmon\|jesień\|none\|w linii=tak}}	zima przedwiośnie wiosna lato złota jesień jesień

Błędy

Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.