重要資訊:自 2012 年 4 月 20 日起,Google 圖表的「圖片圖表」部分已正式淘汰。根據淘汰政策,這項政策仍然有效。
簡介
使用 Google Charts API 與圖片一併呈現的單一或多個走勢圖。這些圖片包含在 HTML 表格中。
範例
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["imagesparkline"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Revenue', 'Licenses'], [435, 132], [438, 131], [512, 137], [460, 142], [491, 140], [487, 139], [552, 147], [511, 146], [505, 151], [509, 149] ]); var chart = new google.visualization.ImageSparkLine(document.getElementById('chart_div')); chart.draw(data, {width: 120, height: 40, showAxisLines: false, showValueLabels: false, labelPosition: 'left'}); } </script> </head> <body> <div id="chart_div" style="width: 120px; height: 40px;"></div> </body> </html>
載入中
google.charts.load
套件名稱為 "imagesparkline"
。
google.charts.load("current", {packages: ["imagesparkline"]});
視覺化的類別名稱是 google.visualization.ImageSparkLine
。
var visualization = new google.visualization.ImageSparkLine(container);
資料格式
不限欄數。所有欄應為數字。 每一欄都會顯示為單一走勢。
設定選項
名稱 | 類型 | 預設 | 說明 |
---|---|---|---|
顏色 | string | 指定要用於所有圖表的顏色。格式為 #rrggbb 的字串。例如:「#00cc00」。只有在未指定 colors 選項時才能使用。 |
|
顏色 | 字串陣列 | 預設色彩 | 資料欄的色彩。 字串陣列,每個元素都是格式為 #rrggbb 的字串。 例如:「#00cc00」。資料欄 i 會使用顏色 i。如果顏色數目小於欄數,則所選顏色會換行。 |
填滿 | 布林值 | 否 | 如為 true,則會在彩色行下方填滿區域。 |
height | 數字 | 容器高度 | 圖片的高度 (以像素為單位)。 |
標籤位置 | string | 無 | 標籤的位置。支援的值為「none」、「left」、「right」。 |
最高 | 數字陣列 | 每個波形圖的最大資料值 | 每個走勢的資料值範圍最大值。 陣列中的索引必須與 DataTable 中的資料欄索引相符。如果所有值都是空值,這就會成為系列中的最大值。 |
分 | 數字陣列 | 每個走勢圖的最低資料值 | 每個走勢資料值範圍的最低值。 陣列中的索引必須與 DataTable 中的資料欄索引相符。如果所有值都是空值,這就會是系列中的最小值。 |
showAxis 線 | 布林值 | true | 如果為 true,系統會顯示軸線。如為 false,則不顯示,且 ShowValueLabels 的預設值為 false。 |
showValueLabels | 布林值 | true,除非 showAxisLines 為 false 除外。 | 如果為 true,系統會顯示值軸標籤。 |
title | 字串陣列 | 不顯示任何標題 | 每個走勢所使用的標題。 |
width | 數字 | 容器寬度 | 圖表的寬度 (以像素為單位)。 |
版面配置 | string | v 鍵 | 垂直或水平版面配置:「v」表示垂直,「h」表示垂直。 |
方法
方法 | 傳回類型 | 說明 |
---|---|---|
draw(data, options) |
無 | 繪製圖表。 |
getSelection() |
所選元素的陣列 | 傳回所選圖表的索引,做為物件的陣列。每個物件都有一個資料欄屬性,其中包含所選走勢的欄數。可傳回多個所選欄。 |
setSelection(selection) |
無 | 選擇指定的走勢,然後取消選取任何未指定的走勢。選項是物件陣列,每個物件都有一個數字 column 屬性,也就是所選走勢的索引。詳情請參閱 setSelection() 。 |
活動
名稱 | 說明 | 屬性 |
---|---|---|
選取 | 標準選取事件。 | 無 |
資料政策
請參閱 Chart API 記錄政策。