Szablon:Legenda

 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

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)

1. kolor – kod koloru (parametr CSS; wyjaśnienie w sekcji kolory) kwadratu z opisem
2. opis – opis związany z kolorem wskazanym wyżej
3. 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.

Zobacz też

• {{Colorbox}}
• {{Kolor}}
• {{Tło}}
• Pomoc:Kolory