Szablon:Piechart

Dokumentacja szablonu[zobacz] [edytuj] [historia] • [odśwież] • § podstrony

Ten szablon używa języka skryptowego Lua. Wywołuje Moduł:Piechart.

Użycie

Smooth piechart – wykresy kołowe z gładkimi liniami. Obsługuje w zasadzie dowolną liczbę wartości.

Opis parametrów

1=[{},{},...]: JSON z danymi wykresu (patrz przykłady).; Jedna pozycja danych to typowo: {"label": "kobiet", "value": 750}.; Pomiędzy pozycjami danych należy wstawić przecinek.; Możliwe właściwości: label, value, color.
meta={}: Dodatkowe metadane (opcje). Również w formacie JSON (patrz przykłady).; Możliwe opcje: size (sz. koła), width (sz. pudełka), autoscale (dla wartości), legend (true/false), direction (flex), caption (dla legendy).; Wszystkie opcje, ich opis i domyślne wartości można znaleźć w module w funkcji: p.setupOptions.

Tabela parametrów (opis strukturalny)

Szablon do tworzenia wykresów kołowych (proporcjonalnie podzielonych okręgów). Wartości są przybliżone i mogą być automatycznie przeskalowane do 100%.

Parametry szablonu[Zarządzaj dokumentacją szablonu]
Dla tego szablonu preferowane jest formatowanie parametrów w bloku.
Parametr		Opis	Typ	Status
Elementy wykresu	`1`	Tablica elementów wykresu, z których każdy jest zbiorem właściwości wycinka: wartość, etykieta i kolor. Dla większości elementów wymagana jest tylko „value” (dla ostatniego elementu nawet to może być pominięte). Kolory można pominąć – zostaną przypisane automatycznie. Zamiast tego parametru możesz użyć także „value1”, „label1”, „color1”… Przykład {"label": "słodycze", "value": 5, "color": "darkred"}	Ciąg znaków	sugerowany
labelformat	`labelformat`	Format wartości w trybie JSON. $auto jest interpretowane inaczej, gdy automatyczne skalowanie jest włączone. Sugerowane wartości `$label: $auto` `$percent [$value]: $label` Wartość domyślna $label: $auto	Linia	sugerowany
legend	`legend`	Jeśli ustawione na true, zostanie dodana legenda. Domyślnie true, jeśli użyto parametru thumb. Sugerowane wartości `true` `false` Wartość domyślna true	Linia	sugerowany
direction	`direction`	Określa rozmieszczenie legendy. Wykres i legenda mogą być ułożone w kolumnie lub w wierszu. Sugerowane wartości `row` `row-reverse` `column` `column-reverse` Wartość domyślna row	Linia	opcjonalny
autoscale	`autoscale`	Jeśli ustawione na true, suma wartości zostanie automatycznie przeskalowana do 100%. Skalowanie jest zawsze włączone, gdy suma przekracza 100. Sugerowane wartości `true` `false` Wartość domyślna false	Linia	sugerowany
precision	`precision`	Precyzja formatowania liczby procentowej (liczba cyfr po przecinku). Sugerowane wartości `-1` `0` `1` `2` Wartość domyślna -1	Liczba	opcjonalny
caption	`caption`	Określa podpis wykresu, wyświetlany przed legendą. Używaj tylko, jeśli legenda jest włączona. Podpis może zawierać odwołania.	Linia	opcjonalny
footer	`footer`	Określa stopkę wykresu, wyświetlaną po legendzie. Używaj tylko, jeśli legenda jest włączona.	Linia	opcjonalny
radius	`radius`	Określa promień wykresu kołowego w pikselach. Jeśli pominięty, domyślnie 100.	Liczba	opcjonalny
width	`width`	Określa rozmiar pola w pikselach. Usuń ten parametr, aby rozmiar dostosowywał się automatycznie (na podstawie etykiet i wielkości wykresu).	Liczba	opcjonalny
value1	`value1`	Wartość pierwszego elementu (używane zamiast tablicy elementów wykresu).	Nieznany	opcjonalny
label1	`label1`	Etykieta pierwszego elementu (używane zamiast tablicy elementów wykresu).	Nieznany	opcjonalny
color1	`color1`	Kolor pierwszego elementu/wycinka (używane zamiast tablicy elementów wykresu).	Nieznany	opcjonalny
value2	`value2`	brak opisu	Nieznany	opcjonalny
label2	`label2`	brak opisu	Nieznany	opcjonalny
color2	`color2`	brak opisu	Nieznany	opcjonalny
value3	`value3`	brak opisu	Nieznany	opcjonalny
label3	`label3`	brak opisu	Nieznany	opcjonalny
color3	`color3`	brak opisu	Nieznany	opcjonalny
value4	`value4`	brak opisu	Nieznany	opcjonalny
label4	`label4`	brak opisu	Nieznany	opcjonalny
color4	`color4`	brak opisu	Nieznany	opcjonalny
value5	`value5`	brak opisu	Nieznany	opcjonalny
label5	`label5`	brak opisu	Nieznany	opcjonalny
color5	`color5`	brak opisu	Nieznany	opcjonalny
value6	`value6`	brak opisu	Nieznany	opcjonalny
label6	`label6`	brak opisu	Nieznany	opcjonalny
color6	`color6`	brak opisu	Nieznany	opcjonalny
value7	`value7`	brak opisu	Nieznany	opcjonalny
label7	`label7`	brak opisu	Nieznany	opcjonalny
color7	`color7`	brak opisu	Nieznany	opcjonalny
value8	`value8`	brak opisu	Nieznany	opcjonalny
label8	`label8`	brak opisu	Nieznany	opcjonalny
color8	`color8`	brak opisu	Nieznany	opcjonalny
value9	`value9`	brak opisu	Nieznany	opcjonalny
label9	`label9`	brak opisu	Nieznany	opcjonalny
color9	`color9`	brak opisu	Nieznany	opcjonalny
value10	`value10`	brak opisu	Nieznany	opcjonalny
label10	`label10`	brak opisu	Nieznany	opcjonalny
color10	`color10`	brak opisu	Nieznany	opcjonalny
other-label	`other-label`	brak opisu	Nieznany	opcjonalny
other-color	`other-color`	brak opisu	Nieznany	opcjonalny
other	`other`	brak opisu	Nieznany	opcjonalny

Przykład

Minimalistyczne

Zwróć uwagę, że drugiej wartości nie trzeba podawać, bo jest wyliczana (zakładamy że sumują się do 100).

{{Piechart| [ {"value":33.3},  {} ] }}

Wersja z etykietami

Dodane etykiety (label) oraz legenda (w meta).

{{Piechart| [
 {"label": "kobiet", "value": 33.3}, 
 {"label": "mężczyzn"}
]
| meta = {"legend":true}
}}

kobiet: 33,3%
mężczyzn: 66,7%

Albo to samo ze zwykłego parametru:

{{Piechart| [
 {"label": "kobiet", "value": 33.3}, 
 {"label": "mężczyzn"}
]
| legend = true / 1
}}

kobiet: 33,3%
mężczyzn: 66,7%

Automatyczne skalowanie

W wypadku gdzie nie masz obliczonych procentów możesz użyć automatycznego skalowania. Musisz jedynie podać obie wartości w tym wypadku.

{{Piechart| [
 {"label": "kobiet", "value": 750}, 
 {"label": "mężczyzn", "value": 250}
]
| legend = true
}}

kobiet: 750 (75,0%)
mężczyzn: 250 (25,0%)

Wiele wartości

Szablon umożliwia wyświetlenie wielu wartości, nie tylko 2.

{{Piechart| [
 {"label": "ciastka", "value": 2, "color":"goldenrod"},
 {"label": "napoje", "value": 1, "color":"#ccf"},
 {"label": "słodycze", "value": 5, "color":"darkred"},
 {"label": "kanapki", "value": 3, "color":"wheat"}
]
| autoscale = true
| legend = true
}}

ciastka: 2 (18,2%)
napoje: 1 (9,09%)
słodycze: 5 (45,5%)
kanapki: 3 (27,3%)

Zwróć uwagę, że w tym wypadku konieczne było podanie dodatkowej opcji autoscale. Jest to konieczne gdy suma liczba jest mniejsza niż 100.

Legenda i jej położenie

Legendę dodajemy za pomocą opcji legend (jak widać powyżej). Można jednak również zmienić kolejność elementów legenda i wykres za pomocą opcji direction (z ang. „kierunek”). Możliwe wartości to:

row (domyślne) – kolejność to legenda, wykres;
row-reverse – kolejność odwrotna, czyli: wykres, legenda;
column – ułożenie kolumnowe (w pionie).
column-reverse – ułożenie kolumnowe, odwrócone (wykres na górze).

{{Piechart| [
 {"label": "ciastka", "value": 2, "color":"goldenrod"},
 {"label": "napoje", "value": 1, "color":"#ccf"},
 {"label": "słodycze", "value": 5, "color":"darkred"},
 {"label": "kanapki", "value": 3, "color":"wheat"}
]
|autoscale=true
|legend=true
|direction=row-reverse
}}

row (domyślny direction)

ciastka: 2 (18,2%)
napoje: 1 (9,09%)
słodycze: 5 (45,5%)
kanapki: 3 (27,3%)

row-reverse

ciastka: 2 (18,2%)
napoje: 1 (9,09%)
słodycze: 5 (45,5%)
kanapki: 3 (27,3%)

column

ciastka: 2 (18,2%)
napoje: 1 (9,09%)
słodycze: 5 (45,5%)
kanapki: 3 (27,3%)

column-reverse

ciastka: 2 (18,2%)
napoje: 1 (9,09%)
słodycze: 5 (45,5%)
kanapki: 3 (27,3%)

Zielonkawe ramki dodane dla czytelności przykładów. Normalnie nie są dodawane.

Błędy

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

Zobacz też

Szablon:Demografia powiatu – wykorzystanie Piechart do statystyk powiatów.
{{Wykres słupkowy}} – inna forma prezentowania procentów (dla dużej liczby danych wykres słupkowy jest bardziej czytelny niż kołowy).

Testowe:

Moduł:Piechart/test.

Inne implementacje:

Szablon:Wykres:Kołowy – graph (Vega).

Powyższy opis jest dołączany ze strony Szablon:Piechart/opis. (edytuj | historia)

Edytorzy mogą eksperymentować w brudnopisie (edytuj | różnice) i na stronach testowych (edytuj) tego szablonu.
Zobacz wszystkie podstrony tej strony.

Kategorie należy dodawać do podstrony /opis.