可视化图表：饼图（图片）

重要提示：Google 图表工具的“图片图表”部分自 2012 年 4 月 20 日起已被正式弃用。根据我们的弃用政策，该 API 仍可继续使用。

  1. Overview
  2. 示例
  3. 正在加载
  4. 数据格式
  5. 配置选项
  6. 方法
  7. 事件
  8. 数据政策

概览

使用 Google Charts API 以图片形式呈现的饼图。

示例

 
<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load("current", {packages:["imagepiechart"]});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart() {
        var data = google.visualization.arrayToDataTable([
          ['Task', 'Hours per Day'],
          ['Work',        11],
          ['Eat',         2],
          ['Commute',     2],
          ['Watch TV',    2],
          ['Sleep',       7]
        ]);

        var chart = new google.visualization.ImagePieChart(document.getElementById('chart_div'));

        chart.draw(data, {width: 430, height: 240, title: 'My Daily Activities'});
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 400px; height: 240px;"></div>
  </body>
</html>

正在加载

google.charts.load 软件包名称为 "imagepiechart"：

  google.charts.load('current', {packages: ['imagepiechart']});

该可视化图表的类名称为 google.visualization.ImagePieChart

  var visualization = new google.visualization.ImagePieChart(container);

数据格式

两列。 第一列应为字符串，并且包含切片标签。第二列应为数字，并包含切片值。

配置选项

您可以将以下选项指定为传递到可视化图表的 draw() 方法的 options 对象。

名称 类型 默认 说明
backgroundColor string '#FFFFFF'（白色） 图表的背景颜色，采用 Chart API 颜色格式。
颜色 string 自动选择 指定要用于所有系列的基本颜色；每个系列都将是指定颜色的渐变色。颜色以 Chart API 颜色格式指定。如果指定了 colors，则忽略。
颜色 数组<字符串> 自动选择 用于为每个数据系列指定特定的颜色。颜色以 Chart API 颜色格式指定。 颜色 i 用于数据列 i；如果数据列数多于颜色，则换行到开头。如果一种颜色的变体适用于所有系列，请改用 color 选项。
enableEvents boolean false 使图表抛出用户触发的事件，例如点击或鼠标悬停。 仅支持特定图表类型。请参阅下面的“事件”。
高度 number 容器高度 图表的高度（以像素为单位）。
3D boolean false 如果设置为 true，则显示三维图表。
标签 string “none”

要为每个切片显示的标签（如果有）。请从以下值中进行选择：

  • “none”- 无标签。
  • “value”- 将切片值用作标签。
  • “name”- 使用切片名称（列名称）。
传奇 string “right” 图例在图表上的位置。请从以下值中选择：“top”“bottom”“left”“right”“none”。
标题 string 无标题 要在图表上方显示的文本。
宽度 number 容器宽度 图表的宽度（以像素为单位）。

方法

方法 返回值类型 说明
draw(data, options) 无 绘制图表。

事件

您可以注册以监听通用图片图表页面中所述的事件。

数据政策

请参阅 Chart API 日志记录政策。