模板: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编辑 | 历史
编者可以在本模板的沙盒创建 | 镜像和测试样例创建页面进行实验。
请将模板自身所属的分类添加在文档中。本模板的子页面