环形&饼图(Doughnut and Pie)

饼图和环形图表可能是最常用的图表。它们被分成不同的部分,每个部分的圆弧表示每个数据的比例值。

该图表在展示数据之间的关系比例方面非常出色。

饼图和环形图在 Chart.js 中实际上是同一个类,但有一个不同的默认值 - cutoutPercentage。意味着内部的百分比被减少。饼图默认为 0,甜甜圈默认为 50

该图表在Chart核心中注册了两个别名。除了不同的默认值和不同的别名,其他是完全一样的。

示例用法

  1. // 饼形图
  2. var myPieChart = new Chart(ctx, {
  3. type: "pie",
  4. data: data,
  5. options: options
  6. });
  1. // 环形图
  2. var myDoughnutChart = new Chart(ctx, {
  3. type: "doughnut",
  4. data: data,
  5. options: options
  6. });

数据集属性

环形/饼图允许为每个数据集指定多个属性以显示特定数据集。

名称类型描述
labelString图例和提示中显示的标签名
backgroundColorColor[]数据集中每个数据区域的填充色 参考 颜色(Colors)
borderColorColor[]边框色 参考 颜色(Colors)
borderWidthNumber[]边框宽度
hoverBackgroundColorColor[]鼠标悬浮时的填充色
hoverBorderColorColor[]鼠标悬浮时边框色
hoverBorderWidthNumber[]鼠标悬浮时边框宽度

配置选项

这些是 Pie&Donut 图表特有的自定义选项。这些选项与全局图表配置选项合并,组成最终选项。

名称类型默认值描述
cutoutPercentageNumber50 - for doughnut, 0 - for pie从中间切出的图表的百分比。
rotationNumber-0.5 Math.PI起始角度
circumferenceNumber2 Math.PI允许图形覆盖
animation.animateRotateBooleantrue如果为 true,则图表将使用旋转动画进行动画。该属性在options.animation对象中。
animation.animateScaleBooleanfalse如果为 true,则将动画从中心向外缩放图表。

默认选项

我们也可以为创建的每个环形图表更改这些默认值,该配置选项在Chart.defaults.doughnut中可用。饼图还可以在Chart.defaults.pie中使用同样的值,唯一的区别是cutoutPercentage被设置为 0。

数据结构

对于饼图,数据集需要包含一组数据点。数据点应该是一个数字,Chart.js 将所有的数字汇总并计算每个数据的相对比例。

你还需要指定一个标签数组,以便在 tooltips 中显示

  1. data = {
  2. datasets: [
  3. {
  4. data: [10, 20, 30]
  5. }
  6. ],
  7. // These labels appear in the legend and in the tooltips when hovering different arcs
  8. labels: ["Red", "Yellow", "Blue"]
  9. };