此模板用於製作餅圖,為每個區域指定不同的數值、標籤和顏色,同時顯示一個圖例(模板鏈接:{{legend}})。
用法
基本用法
每個餅圖由多個項組成。每個項可以指定以下的基本參數(其中n是一個正整數):
labeln
- 表示第n個項的標籤。
valuen
- 表示第n個項的值。
colorn
- 表示第n項在圖表和圖例中顯示的顏色,如果沒有指定,則會自動指定。必須是一個有效的CSS顏色。
此外,還有以下的基本參數:
thumb
- 顯示格式,可接受的值為
left
、center
、right
和none
。注意:在屏幕較窄的視圖下,可能始終顯示在內容的中間。
例如:
{{pie chart |value1 = 32 |label1 = 紅色的部分 |color1 = red |value2 = 42 |label2 = 黃色的部分 |color2 = yellow |value3 = 28 |label3 = 藍色的部分 |color3 = blue |value4 = 9 |label4 = 品紅色的部分 |color4 = magenta |thumb = center }}
指定半徑
你可以為整個圖表,或者為單個元素指定半徑。對單個圖標半徑的設置不影響整個圖表的顯示。
radius
- 圖表的半徑,其值為CSS的長度,例如
80px
、3em
。如果沒有指定單位,則默認為像素(px
)。 radiusn
- 圖表的第n項的半徑,其值為CSS的長度,如果沒有指定單位則無效。
注意:半徑是長度,因此需要指定單位。對於radius
參數,允許省略單位,這是為了保持兼容性。
例如:
{{pie chart |radius = 80px |value1 = 3 |label1 = 1號線 |color1 = {{上海地鐵顏色|1|s}} |value2 = 4 |label2 = 2號線 |color2 = {{上海地鐵顏色|2|s}} |value3 = 1.8 |label3 = 3號線 |color3 = {{上海地鐵顏色|3|s}} |radius3 = 90px |value4 = 0.8 |label4 = 4號線 |color4 = {{上海地鐵顏色|4|s}} |radius4 = calc(80px - 1em) |thumb = right }}
圖例
你可以指定圖例的顯示。
circleOnly
- 如果為
true
,則呈現的結果只有圖表本身的部分,沒有邊框和圖例。 legend
- 如果為
false
,則不顯示圖例。默認為true
caption
- 顯示在圖例上方的描述性文本。
footer
- 顯示在圖例下方的描述性文本。
info
- 顯示在圖例標籤後面的信息類型,可以接受的值為
percentage
、value
或none
。 infon
- 類似於
info
,但是只會指定第n項元素。
{{Pie chart |value1 = 20 |value2 = 30 |value3 = 40 |circleOnly = true}}
{{pie chart |value1 = 20 |value2 = 30 |value3 = 40 |value4 = 20 |label1 = 第1項的標籤 |label2 = 第2項的標籤 |info=value |info3=none |caption=上方文本 |footer=下方文本 }}
偏移
你可以將特定的圖表項的扇形向外偏移。
offset
- 指定所有圖標值的向外偏移值,其值是一個CSS長度。默認為0。
offsetn
- 指定第n項元素的向外偏移,其值是一個CSS長度。
{{pie chart |value1 = 10 |value2 = 20 |value3 = 15 |value4 = 18 |offset = 5px |offset2 = 0 |offset3 = 10px |radius4 = 80px }}
其他參數
total
- 指定總數值,必須是數字。如果不存在,則自動加總所有的數值。
other
- 是否顯示「其他」項,默認為
false
。如果為true
,那麼「其他」項的值相當於total
的值減去所有值的總和。 space
- 指定圖表中各項之間的間隔。注意各項之間的間隔依然也是扇形。其值可以是:
- CSS的角度值,例如
2deg
、0.05turn
。 - 數值,表示該數值在圖表中對應的角度。
- CSS的角度值,例如
示例:
{{pie chart |total = 100 |other = true |space = 2deg |value1 = 20 |value2 = 30 |value3 = 5 |value4 = 0.7 |value5 = 0.1 }}
無障礙考慮
本模板產生的圖表和圖例的顏色部分,不受深色模式影響。
圖表元素內添加了文本,以描述此內容的標籤、百分比等。這些文本不會顯示,但是會被屏幕閱讀器朗讀。
模板數據
用於創建一個餅圖,並帶有圖例。
參數 | 描述 | 類型 | 狀態 | |
---|---|---|---|---|
半徑 | radius | 圖表的半徑,必須是有效的CSS長度。
| 字串 | 非必填 |
偏移 | offset | 設置各個圖表元素向外偏移的長度,必須是有效的CSS長度。
| 字串 | 非必填 |
顯示位置 | thumb | 控制整個模板的顯示位置,可接受的值有left、center、right、none。
| 字串 | 非必填 |
間隔 | space | 各個圖表項之間的間隔,可以是CSS角度值,也可以是數字以表示其在圖表中對應的角度。
| 字串 | 非必填 |
信息類型 | info | 顯示圖例中的信息的類型。可以是percentage、value和none。
| 字串 | 非必填 |
圖例上方文本 | caption | 顯示在圖例上方的文本。 | 行 | 非必填 |
圖例下方文本 | footer | 顯示在圖例下方的文本。 | 行 | 非必填 |
總數值 | total | 圖表各項元素的總數值。如果沒有指定,則自動將各項元素的數值相加。
| 數值 | 非必填 |
顯示「其他」項 | other | 是否顯示「其他」項,其值為指定的總數值減去各項數值的總和。
| 布林值 | 非必填 |
是否顯示圖例 | legend | 是否顯示圖例。
| 布林值 | 非必填 |
僅顯示圓餅部分 | circleOnly | 如果為true,則僅顯示圖表中的圓餅的部分,沒有邊框、文本和圖例。
| 布林值 | 非必填 |
標籤1 | label1 | 第1個圖表項的標籤。 | 行 | 建議 |
數值1 | value1 | 第1個項的數值。
| 數值 | 建議 |
顏色1 | color1 | 第1個項的顏色,必須是CSS顏色值。可省略。
| 字串 | 建議 |
半徑1 | radius1 | 第1個圖表項的半徑。必須是有效的CSS長度值。
| 字串 | 非必填 |
信息類型1 | info1 | 第1項在圖例中顯示的信息的類型。
| 字串 | 非必填 |
偏移1 | offset1 | 第1個圖表元素向外偏移的值,必須是有效的CSS長度值。
| 字串 | 非必填 |
標籤2 | label2 | 第2個圖表項的標籤。 | 行 | 建議 |
數值2 | value2 | 第2個項的數值。
| 數值 | 建議 |
顏色2 | color2 | 第2個項的顏色,必須是CSS顏色值。可省略。
| 字串 | 建議 |
半徑2 | radius2 | 第2個圖表項的半徑。必須是有效的CSS長度值。
| 字串 | 非必填 |
信息類型2 | info2 | 第2項在圖例中顯示的信息的類型。
| 字串 | 非必填 |
偏移2 | offset2 | 第2個圖表元素向外偏移的值,必須是有效的CSS長度值。
| 字串 | 非必填 |