模板:Pie chart

本页使用了标题或全文手工转换,现处于繁体转换模式
模板頁面
文檔圖示 模板文件[檢視] [編輯] [查看歷史] [清除快取]

此模板用於製作餅圖,為每個區域指定不同的數值、標籤和顏色,同時顯示一個圖例(模板鏈接:{{legend}})。

用法

基本用法

每個餅圖由多個項組成。每個項可以指定以下的基本參數(其中n是一個正整數):

labeln
表示第n個項的標籤。
valuen
表示第n個項的值。
colorn
表示第n項在圖表和圖例中顯示的顏色,如果沒有指定,則會自動指定。必須是一個有效的CSS顏色。

此外,還有以下的基本參數:

thumb
顯示格式,可接受的值為leftcenterrightnone。注意:在屏幕較窄的視圖下,可能始終顯示在內容的中間。

例如:

{{pie chart
|value1 = 32
|label1 = 紅色的部分
|color1 = red
|value2 = 42
|label2 = 黃色的部分
|color2 = yellow
|value3 = 28
|label3 = 藍色的部分
|color3 = blue
|value4 = 9
|label4 = 品紅色的部分
|color4 = magenta
|thumb = center
}}
餅圖,共4個元素。
餅圖元素,第1項,標籤內容:紅色的部分,數值:32,百分比:28.828828828829%。
餅圖元素,第2項,標籤內容:黃色的部分,數值:42,百分比:37.837837837838%。
餅圖元素,第3項,標籤內容:藍色的部分,數值:28,百分比:25.225225225225%。
餅圖元素,第4項,標籤內容:品紅色的部分,數值:9,百分比:8.1081081081081%。

 紅色的部分(28.828828828829%)

 黃色的部分(37.837837837838%)

 藍色的部分(25.225225225225%)

 品紅色的部分(8.1081081081081%)

指定半徑

你可以為整個圖表,或者為單個元素指定半徑。對單個圖標半徑的設置不影響整個圖表的顯示。

radius
圖表的半徑,其值為CSS的長度,例如80px3em。如果沒有指定單位,則默認為像素(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
}}
餅圖,共4個元素。
餅圖元素,第1項,標籤內容:1號線,數值:3,百分比:31.25%。
餅圖元素,第2項,標籤內容:2號線,數值:4,百分比:41.666666666667%。
餅圖元素,第3項,標籤內容:3號線,數值:1.8,百分比:18.75%。
餅圖元素,第4項,標籤內容:4號線,數值:0.8,百分比:8.3333333333333%。

 1號線(31.25%)

 2號線(41.666666666667%)

 3號線(18.75%)

 4號線(8.3333333333333%)

圖例

你可以指定圖例的顯示。

circleOnly
如果為true,則呈現的結果只有圖表本身的部分,沒有邊框和圖例。
legend
如果為false,則不顯示圖例。默認為true
caption
顯示在圖例上方的描述性文本。
footer
顯示在圖例下方的描述性文本。
info
顯示在圖例標籤後面的信息類型,可以接受的值為percentagevaluenone
infon
類似於info,但是只會指定第n項元素。
{{Pie chart
|value1 = 20 |value2 = 30 |value3 = 40 |circleOnly = true}}
餅圖,共3個元素。
餅圖元素,第1項,數值:20,百分比:22.222222222222%。
餅圖元素,第2項,數值:30,百分比:33.333333333333%。
餅圖元素,第3項,數值:40,百分比:44.444444444444%。
{{pie chart
|value1 = 20 |value2 = 30 |value3 = 40 |value4 = 20
|label1 = 第1項的標籤 |label2 = 第2項的標籤
|info=value |info3=none |caption=上方文本 |footer=下方文本
}}
餅圖,共4個元素。
餅圖元素,第1項,標籤內容:第1項的標籤,數值:20,百分比:18.181818181818%。
餅圖元素,第2項,標籤內容:第2項的標籤,數值:30,百分比:27.272727272727%。
餅圖元素,第3項,數值:40,百分比:36.363636363636%。
餅圖元素,第4項,數值:20,百分比:18.181818181818%。
上方文本

 第1項的標籤(20)

 第2項的標籤(30)

 20

下方文本

偏移

你可以將特定的圖表項的扇形向外偏移。

offset
指定所有圖標值的向外偏移值,其值是一個CSS長度。默認為0。
offsetn
指定第n項元素的向外偏移,其值是一個CSS長度。
{{pie chart
|value1 = 10 |value2 = 20 |value3 = 15 |value4 = 18
|offset = 5px |offset2 = 0 |offset3 = 10px |radius4 = 80px
}}
餅圖,共4個元素。
餅圖元素,第1項,數值:10,百分比:15.873015873016%。
餅圖元素,第2項,數值:20,百分比:31.746031746032%。
餅圖元素,第3項,數值:15,百分比:23.809523809524%。
餅圖元素,第4項,數值:18,百分比:28.571428571429%。

 15.873015873016%

 31.746031746032%

 23.809523809524%

 28.571428571429%

其他參數

total
指定總數值,必須是數字。如果不存在,則自動加總所有的數值。
other
是否顯示「其他」項,默認為false。如果為true,那麼「其他」項的值相當於total的值減去所有值的總和。
space
指定圖表中各項之間的間隔。注意各項之間的間隔依然也是扇形。其值可以是:
  • CSS的角度值,例如2deg0.05turn
  • 數值,表示該數值在圖表中對應的角度。

示例:

{{pie chart
|total = 100 |other = true |space = 2deg
|value1 = 20 |value2 = 30 |value3 = 5 |value4 = 0.7 |value5 = 0.1
}}
餅圖,共5個元素。
餅圖元素,第1項,數值:20,百分比:20%。
餅圖元素,第2項,數值:30,百分比:30%。
餅圖元素,第3項,數值:5,百分比:5%。
餅圖元素,第4項,數值:0.7,百分比:0.7%。
餅圖元素,第5項,數值:0.1,百分比:0.1%。

 20%

 30%

 5%

 0.7%

 0.1%

 其他(44.2%)

無障礙考慮

本模板產生的圖表和圖例的顏色部分,不受深色模式影響。

圖表元素內添加了文本,以描述此內容的標籤、百分比等。這些文本不會顯示,但是會被屏幕閱讀器朗讀。

模板數據

Pie chart模板資料

用於創建一個餅圖,並帶有圖例。

模板參數[編輯模板資料]

此模板以參數區塊格式為優先。

參數描述類型狀態
半徑radius

圖表的半徑,必須是有效的CSS長度。

預設
100px
範例
80px、5em
字串非必填
偏移offset

設置各個圖表元素向外偏移的長度,必須是有效的CSS長度。

預設
0
範例
2px
字串非必填
顯示位置thumb

控制整個模板的顯示位置,可接受的值有left、center、right、none。

建議值
left center right none
預設
right
範例
center
字串非必填
間隔space

各個圖表項之間的間隔,可以是CSS角度值,也可以是數字以表示其在圖表中對應的角度。

預設
0turn
範例
2deg
字串非必填
信息類型info

顯示圖例中的信息的類型。可以是percentage、value和none。

建議值
percentage value none
預設
percentage
範例
none
字串非必填
圖例上方文本caption

顯示在圖例上方的文本。

非必填
圖例下方文本footer

顯示在圖例下方的文本。

非必填
總數值total

圖表各項元素的總數值。如果沒有指定,則自動將各項元素的數值相加。

範例
100
數值非必填
顯示「其他」項other

是否顯示「其他」項,其值為指定的總數值減去各項數值的總和。

預設
0
布林值非必填
是否顯示圖例legend

是否顯示圖例。

預設
1
布林值非必填
僅顯示圓餅部分circleOnly

如果為true,則僅顯示圖表中的圓餅的部分,沒有邊框、文本和圖例。

預設
0
布林值非必填
標籤1label1

第1個圖表項的標籤。

建議
數值1value1

第1個項的數值。

範例
20
數值建議
顏色1color1

第1個項的顏色,必須是CSS顏色值。可省略。

預設
自動決定
範例
red、blue
字串建議
半徑1radius1

第1個圖表項的半徑。必須是有效的CSS長度值。

預設
取決於radius參數
範例
90px
字串非必填
信息類型1info1

第1項在圖例中顯示的信息的類型。

建議值
percentage value none
預設
取決於info參數。
字串非必填
偏移1offset1

第1個圖表元素向外偏移的值,必須是有效的CSS長度值。

預設
取決於offset參數
範例
1px
字串非必填
標籤2label2

第2個圖表項的標籤。

建議
數值2value2

第2個項的數值。

範例
20
數值建議
顏色2color2

第2個項的顏色,必須是CSS顏色值。可省略。

預設
自動決定
範例
red、blue
字串建議
半徑2radius2

第2個圖表項的半徑。必須是有效的CSS長度值。

預設
取決於radius參數
範例
90px
字串非必填
信息類型2info2

第2項在圖例中顯示的信息的類型。

建議值
percentage value none
預設
取決於info參數。
字串非必填
偏移2offset2

第2個圖表元素向外偏移的值,必須是有效的CSS長度值。

預設
取決於offset參數
範例
1px
字串非必填


上述文檔內容嵌入自Template:Pie chart/doc編輯 | 歷史
編者可以在本模板的沙盒創建 | 鏡像和測試樣例創建頁面進行實驗。
請將模板自身所屬的分類添加在文檔中。本模板的子頁面