重要事項:Google 圖表工具的「圖片圖表」部分已自 2012 年 4 月 20 日起正式淘汰。但請放心,該功能將根據淘汰政策持續運作。
總覽
使用 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);
資料格式
兩欄。 第一欄應為字串且包含切片標籤。 第二欄應為數字且包含片段值。
設定選項
您可以在 options 物件中指定下列選項,該物件會傳遞至視覺化的 draw() 方法。
| 名稱 | 類型 | 預設 | 說明 |
|---|---|---|---|
| backgroundColor | 字串 | 「#FFFFFF」(白色) | 圖表 API 顏色格式的圖表背景顏色。 |
| 顏色 | 字串 | 自動 | 指定所有序列要使用的基本顏色;每個系列都會是指定顏色的階梯。您可以使用圖表 API 顏色格式指定顏色,如果指定 colors,系統會忽略這項設定。 |
| 顏色 | 陣列<字串> | 自動 | 藉此為各個資料序列指定特定顏色。您可以使用圖表 API 顏色格式指定顏色。顏色 i 會用於資料欄 i,如果資料欄超過顏色,則會從頭到頭換行。如果所有系列都接受單一顏色的變化版本,請改用 color 選項。 |
| enableEvents | boolean | false | 讓圖表擲回使用者觸發的事件,例如點擊或滑鼠遊標懸停。僅支援特定圖表類型。請參閱下方的「事件」一節。 |
| 高度 | 號碼 | 容器高度 | 圖表的高度 (以像素為單位)。 |
| 是 3D | boolean | false | 如果設為 True,則會顯示 3D 圖表。 |
| 標籤 | 字串 | 「無」 | 每個片段顯示的標籤 (如有)。請選擇下列值:
|
| 傳說 | 字串 | 「右」 | 圖表中圖例的位置。請選擇下列其中一個值:「top」、「bottom」、「left」、「right」或「none」。 |
| title | 字串 | 無標題 | 顯示在圖表上方的文字。 |
| 寬度 | 號碼 | 容器寬度 | 圖表的寬度 (以像素為單位)。 |
方法
| 方法 | 傳回類型 | 說明 |
|---|---|---|
draw(data, options) |
無 | 繪製圖表。 |
事件
您可以註冊聆聽一般圖片圖表網頁中所述的事件。
資料政策
請參閱「圖表 API 記錄政策」。