此模板用于制作饼图,为每个区域指定不同的数值、标签和颜色,同时显示一个图例(模板链接:{{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长度值。
| 字符串 | 可选 |