視覺化呈現：柱狀圖

此為動畫的時間長度，以毫秒為單位。詳情請參閱動畫說明文件。

套用至動畫的加/減速功能。可用選項如下所示：

• 「線性」- 固定速度。
• 「in」 - 減輕 - 開始緩慢並加快速度。
• 'out' - 簡化 - 啟動並放慢速度。
• 「inAndOut」- 加速進出，先放慢速度、放慢速度再放慢。

指定圖表是否會在初次繪圖時顯示動畫。如果設為 true，圖表會從基準開始，並動畫呈現最終狀態。

在長條圖和 資料欄圖表中，如果設為 true，則會繪製長條圖/資料欄以外的所有註解。

如果圖表支援註解，annotations.boxStyle 物件會控制註解周圍方塊的外觀：

var options = {
  annotations: {
    boxStyle: {
      // Color of the box outline.
      stroke: '#888',
      // Thickness of the box outline.
      strokeWidth: 1,
      // x-radius of the corner curvature.
      rx: 10,
      // y-radius of the corner curvature.
      ry: 10,
      // Attributes for linear gradient fill.
      gradient: {
        // Start color for gradient.
        color1: '#fbf6a7',
        // Finish color for gradient.
        color2: '#33b679',
        // Where on the boundary to start and
        // end the color1/color2 gradient,
        // relative to the upper left corner
        // of the boundary.
        x1: '0%', y1: '0%',
        x2: '100%', y2: '100%',
        // If true, the boundary for x1,
        // y1, x2, and y2 is the box. If
        // false, it's the entire chart.
        useObjectBoundingBoxUnits: true
      }
    }
  }
};
    

這個選項目前支援區域、長條圖、柱狀圖、組合圖、折線圖和散佈圖。註解圖表不支援此功能。

var options = {
  annotations: {
    textStyle: {
      fontName: 'Times-Roman',
      fontSize: 18,
      bold: true,
      italic: true,
      // The color of the text.
      color: '#871b47',
      // The color of the text outline.
      auraColor: '#d799ae',
      // The transparency of the text.
      opacity: 0.8
    }
  }
};
    

這個選項目前支援區域、長條圖、柱狀圖、組合圖、折線圖和散佈圖。 註解圖表 不支援此功能。

比較軸標題和圖表區域的位置。支援的值：

• 內 - 在圖表區域繪製軸標題。
• 消失 - 在圖表區域外繪製軸標題。
• 無 - 省略軸標題。

圖表主要區域的背景顏色。可以是簡單的 HTML 顏色字串 (例如 'red' 或 '#00cc00')，或具有下列屬性的物件。

圖表邊框顏色，以 HTML 顏色字串表示。

邊框寬度 (以像素為單位)。

圖表填滿顏色，以 HTML 顏色字串表示。

• 像素 (例如 50)。
• 每個群組可用的寬度百分比 (例如「20%」)，「100%」表示各群組之間沒有任何空格。

Material 長條圖中的長條是垂直或水平。這個選項不會影響傳統長條圖或傳統柱狀圖。

此物件可讓成員設定圖表區域的位置和大小 (繪製圖表時不含軸和圖例)。系統支援兩種格式：一個數字，或後接 % 的數字。簡單數字是以像素為單位的值，數字後面加上 % 代表百分比。範例：chartArea:{left:20,top:0,width:'50%',height:'75%'}

• stroke：以十六進位字串或英文顏色名稱提供的顏色。
• strokeWidth：如有提供，會在指定寬度的圖表區域 (以及 stroke 的顏色) 周圍繪製邊框。

從左框線繪製圖表的時間長度。

圖表與上框線的繪製距離。

圖表區域寬度。

圖表區域高度。

在質感設計圖表中，此選項可指定字幕。只有質感圖表支援字幕。

在質感設計圖表中，此選項可指定標題。

圖表元素要使用的顏色。字串陣列，其中每個元素都是 HTML 顏色字串，例如：colors:['red','#004411']。

資料點的透明度，1.0 表示完全不透明，0.0 則完全透明。 在散佈圖、直方圖、長條圖和柱狀圖中，這是指可見資料：散佈圖中的圓點和其他矩形中的矩形。在選取資料的圖表中，系統會建立圓點 (例如折線和面積圖)，指的是懸停或選取時顯示的圓形。組合圖同時呈現出兩種行為，而這個選項對其他圖表沒有影響。(如要變更趨勢線的不透明度，請參閱 趨勢線不透明度 相關說明)。

圖表是否會擲回以使用者為基礎的事件，或是對使用者互動做出反應。如果設為 False，圖表不會擲回「select」或其他互動型事件 (但「會」擲回已就緒或錯誤的事件)，且不會顯示懸停文字，或根據使用者輸入內容而變更。

explorer 選項可讓使用者平移及縮放 Google 圖表。explorer: {} 提供預設的探索工具行為，讓使用者可透過拖曳來水平和垂直平移，以及捲動畫面來縮放畫面。

這項功能仍在實驗階段，未來版本可能會有所異動。

注意：多層檢視僅適用於連續軸 (例如數字或日期)。

Google 圖表探索工具支援三種操作：

• dragToPan：拖曳即可水平和垂直平移圖表。如要僅沿著水平軸平移，請使用 explorer: { axis: 'horizontal' }。垂直軸也很類似。
• dragToZoom：探索工具的預設行為是在使用者捲動畫面時放大和縮小。如果使用 explorer: { actions: ['dragToZoom', 'rightClickToReset'] }，沿著矩形區域拖曳即可放大該區域。建議您在使用 dragToZoom 時一律使用 rightClickToReset。如要自訂縮放比例，請參閱 explorer.maxZoomIn、explorer.maxZoomOut 和 explorer.zoomDelta。
• rightClickToReset：在圖表上按一下滑鼠右鍵，即可將圖表恢復至原始的平移和縮放等級。

根據預設，使用 explorer 選項時，使用者可以水平和垂直平移。如果您只想橫向平移，請使用 explorer: { axis: 'horizontal' }。同樣地，explorer: { axis: 'vertical' } 會啟用僅限垂直的平移功能。

根據預設，無論資料位於何處，使用者都可以平移所有內容。如要確保使用者不會平移超出原始圖表範圍，請使用 explorer: { keepInBounds: true }。

探險家可放大的上限。根據預設，使用者可以放大到足夠的畫面，只會看到原始檢視畫面的 25%。設定 explorer: { maxZoomIn: .5 } 能讓使用者只放大到夠大的程度，只看得到原始檢視畫面的一半。

探險家可縮小的最大範圍。根據預設，使用者可以縮小到夠大的範圍，讓圖表只佔用 1/4 的可用空間。如果設定 explorer: { maxZoomOut: 8 }，使用者就能縮小到圖表只佔 1/8 的可用空間。

使用者放大或縮小時，explorer.zoomDelta 會決定其縮放的比例。數字越小，縮放效果也越流暢。

可接收滑鼠遊標懸停動作的實體類型。這也會影響滑鼠點選時所選取的實體，以及與事件相關聯的資料表元素。可以是下列其中一項：

• 「datum」：著重於單一資料點。與資料表中的儲存格建立關聯。
• 「類別」：專注於主要軸上所有資料點的集合。與資料表中的某一列相關聯。

在 FocusTarget 的「類別」中，工具提示會顯示所有類別值。適合用於比較不同序列的值。

圖表中所有文字的預設字型大小 (以像素為單位)。您可以使用特定圖表元素的屬性覆寫這項設定。

圖表中所有文字的預設字型。您可以使用特定圖表元素的屬性覆寫這項設定。

在內嵌頁框中繪製圖表。(請注意，在 IE8 中，系統會忽略此選項；所有 IE8 圖表都會繪製成 iFrame。)

可讓成員設定各種水平軸元素的物件。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

橫軸的基準線。

這個選項僅適用於 continuous 軸。

水平軸的基準顏色。可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。

這個選項僅適用於 continuous 軸。

沿著水平軸的值成長的方向。指定 -1 將值的順序反轉。

數字或日期軸標籤的格式字串。

如為數字軸標籤，這是十進位格式 ICU 模式集 的一部分。舉例來說，{format:'#,###%'} 會針對值 10、7.5 及 0.5，顯示「1,000%」、「750%」和「50%」。您也可以提供下列任一項目：

• {format: 'none'}：顯示不含格式的數字 (例如8000000 顆)
• {format: 'decimal'}：顯示包含千位數分隔符的數字 (例如8,000,000 人)
• {format: 'scientific'}：以科學記號顯示數字 (例如8e6)。
• {format: 'currency'}：以當地幣別顯示數字 (例如$8,000,000.00 美元)
• {format: 'percent'}：以百分比顯示數字 (例如800,000,000%)
• {format: 'short'}：顯示縮寫數字 (例如800 萬)
• {format: 'long'}：將數字顯示為完整的字詞 (例如800 萬)

如為日期軸標籤，這是日期格式 ICU 模式集 的一部分。舉例來說，{format:'MMM d, y'} 會顯示「2011 年 7 月 1 日」這個值，做為 2011 年 7 月的第一天。

套用至標籤的實際格式是衍生自載入 API 時使用的語言代碼。詳情請參閱「 載入特定語言代碼的圖表 」。

計算刻點值和格線時，系統會考慮所有相關格線選項的幾種替代組合，如果格式化的刻點標籤重複或重疊，系統會拒絕替代組合。因此，如果您只想顯示整數刻點值，則可以指定 format:"#"，但請注意，如果沒有替代項目符合這項條件，系統就不會顯示格線或刻點。

這個選項僅支援 continuous 軸。

具有屬性，可設定水平軸格線的物件。請注意，水平軸格線是垂直繪製的。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{color: '#333', minSpacing: 20}

這個選項僅支援 continuous 軸。

圖表區域中的水平格線顏色。指定有效的 HTML 顏色字串。

圖表區域中的水平格線約略數量。 如果為 gridlines.count 指定正數，系統會使用該數字計算格線之間的 minSpacing。 您可以將 1 值指定為只繪製一個格線，指定 0 值則可繪製不繪製格線。指定 -1 (此為預設值)，即可依據其他選項自動計算格線數量。

相鄰格線之間的大小陣列 (做為資料值，而非像素) 陣列。此選項目前只適用於數字軸，但類似於僅適用於日期和時間的 gridlines.units.<unit>.interval 選項。以線性比例來說，預設值為 [1, 2, 2.5, 5]，表示格線值可以採用每單位 (1)、偶數 (2)，或是 2.5 或 5 的倍數。這些值的 10 倍以上也會納入考量 (例如 [10, 20, 25, 50] 和 [.1, .2, .25, .5]。)對數尺標的預設值則為 [1, 2, 5]。

介於 hAxis 主要格線之間的最小螢幕空間 (以像素為單位)。 主要格線比例預設為 40，線性比例則預設為 20。如果指定 count 而非 minSpacing，系統會依據計數計算 minSpacing。相反地，如果您指定 minSpacing 而非 count，則計數會從 minSpacing 計算得出。如果您同時指定兩者，系統會覆寫 minSpacing。

所有格線值和刻度值都必須是這個選項值的倍數。請注意，與間隔不同，10 倍的次方不會考量倍數。因此，您可以指定 gridlines.multiple = 1，將滴答強制設為整數，或者指定 gridlines.multiple = 1000，強制滴答是 1000 的倍數。

將日期/日期時間/時間資料類型與圖表計算的格線搭配使用時，覆寫預設格式。允許格式化年、月、日、小時、分鐘、秒鐘和毫秒。

一般格式為：

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

詳情請參閱日期和時間。

此物件可讓成員在水平軸上設定次要格線，與 hAxis.gridlines 選項類似。

這個選項僅支援 continuous 軸。

圖表區域中的水平小格線顏色。指定有效的 HTML 顏色字串。

minorGridlines.count 選項大部分都已淘汰，除非將計數設為 0 來停用次要格線。次要格線的數量現在完全取決於主要格線之間的間隔 (請參閱 hAxis.gridlines.interval) 和最低所需空間 (請參閱 hAxis.minorGridlines.minSpacing)。

小 Gridlines.interval 選項與主要格線間隔選項類似，但所選的間隔一律為主要格線間隔的偶數除數。線性比例的預設時間間隔為 [1, 1.5, 2, 2.5, 5]，對數尺度的預設間隔為 [1, 2, 5]。

相鄰次要格線之間，以及小型和主要格線之間至少需要的空間 (以像素為單位)。以線性比例尺度來說，主要格線的 minSpacing 為 1/2，對對數比例而言則為 minSpacing 為 1/5。

與主要 gridlines.multiple 相同。

與計算的次要格線搭配使用時，覆寫日期/日期時間/時間資料類型各個面向的預設格式。允許格式化年、月、日、小時、分鐘、秒鐘和毫秒。

一般格式為：

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

詳情請參閱日期和時間。

hAxis 屬性將水平軸設為對數尺度 (要求所有值都必須為正數)。如果為「是」，請設為 true。

這個選項僅適用於 continuous 軸。

hAxis 屬性，讓水平軸成為對數尺度。可以是下列任一值：

• null - 不執行對數縮放。
• 「log」：對數縮放。系統不會繪製負值和零的值。這個選項與設定 hAxis: { logscale: true } 相同。
• 「MirrorLog」：繪製負值和零的對數進行對數縮放。負數的繪製值是絕對值記錄檔的負數。接近 0 的值會以線性比例繪製。

這個選項僅適用於 continuous 軸。

橫軸文字相對於圖表區域的位置。支援的值：「out」、「in」、「none」。

這個物件會指定水平軸文字樣式。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

將自動產生的 X 軸刻點替換為指定的陣列。陣列的每個元素應為有效的刻點值 (例如數字、日期、時間或時間) 或物件。如果是物件，則應提供用於刻點值的 v 屬性，以及選用的 f 屬性，其中含有要顯示為標籤的常值字串。

除非您指定要覆寫的 viewWindow.min 或 viewWindow.max，否則 viewWindow 會自動展開以包含最小和最大滴答。

例：

• hAxis: { ticks: [5,10,15,20] }
• hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

這個選項僅支援 continuous 軸。

hAxis 屬性，指定橫軸的標題。

這個物件會指定水平軸標題文字樣式。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

設為 false 時，可隱藏最外的標籤，以免圖表容器遭到裁剪。如為 true，則可裁剪標籤。

這個選項僅適用於 discrete 軸。

如果設為 true，沿著特定角度繪製水平軸文字，有助於在軸上容納更多文字；如果為 false，則向右繪製水平軸文字。如果繪製時無法完全容納斜體文字，系統會預設行為。請注意，只有在 hAxis.textPosition 設為「out」(預設值) 時，才能使用這個選項。日期和時間預設為 false。

水平軸文字的角度 (如果繪製的話)。如果 hAxis.slantedText 為 false 或處於自動模式，且圖表決定水平繪製文字，則忽略此值。如果角度為正數，則旋轉角度會逆時針旋轉，如為負數，則代表順時針。

水平軸文字層級數量上限。如果軸的文字標籤太擁擠，伺服器可能會將鄰近標籤向上或向下移動，以便將標籤放在較近的位置。這個值會指定最多要使用的層級數；如果標籤可容納不重疊，伺服器可以使用較少的層級。日期和時間的預設值為 1。

文字標籤的行數上限。如果標籤過長，標籤可以橫跨多行。行數預設為可用空間的高度限制。

兩個相鄰文字標籤之間的最小水平間距 (以像素為單位)。如果標籤的間距過於密集或過長，間隔可能會降到這個門檻以下。在這種情況下，系統會套用標籤過於雜亂的措施 (例如截斷標籤或捨棄部分標籤)。

要顯示的水平軸標籤數量；1 代表顯示每個標籤，2 代表顯示所有其他標籤，以此類推。預設設定為盡可能多顯示多個標籤，且不重疊。

將水平軸的最大值移至指定值；在多數圖表中，這個值會向右移動。如果設為值小於資料的最大 x 值，系統會忽略這項設定。 hAxis.viewWindow.max 會覆寫這項屬性。

這個選項僅支援 continuous 軸。

將水平軸的最小值移至指定值；在大多數圖表中，這個數字會向左移動。如果設定的值大於資料中最小值 x 值，系統會忽略這項設定。 hAxis.viewWindow.min 會覆寫這項屬性。

這個選項僅支援 continuous 軸。

指定如何縮放水平軸，以轉譯圖表區域中的值。支援的字串值如下：

• 「漂亮」：縮放水平值，讓最大和最小值在圖表區域的左右兩側顯示。ViewWindow 會展開為最接近的數字主要格線，或找出最接近日期和時間的次要格線。
• 「maximized」：縮放水平值，讓最大和最小值觸及圖表區域的左右兩側。這項操作會忽略 haxis.viewWindow.min 和 haxis.viewWindow.max。
• 「explicit」：已淘汰指定圖表區域左右比例值的選項。(已淘汰，因為 haxis.viewWindow.min 和 haxis.viewWindow.max 是多餘的值)。系統會裁剪這些值以外的資料值。您必須指定 hAxis.viewWindow 物件，說明要顯示的最大值和最小值。

這個選項僅支援 continuous 軸。

指定水平軸的裁剪範圍。

• 如果是 continuous 軸：

  要顯示的水平資料最大值。

• 如果是 discrete 軸：

  裁剪視窗結束的位置，從零開始的資料列索引。系統會將位於這個索引以上數值的資料點遭到裁剪。會與 vAxis.viewWindowMode.min 搭配使用，定義半開啟的範圍 [最小值、最大值)，代表要顯示的元素索引。換句話說，所有能夠顯示 min <= index < max 的索引。

當 hAxis.viewWindowMode 為「漂亮」或「最大化」時，系統會忽略此值。

• 如果是 continuous 軸：

  要顯示的水平資料最小值。

• 如果是 discrete 軸：

  以零為基準的列索引，這是裁剪視窗的起始位置。而索引低於這個值的資料點會遭到裁剪。加上 vAxis.viewWindowMode.max 可定義半開啟的範圍 [最小值、最大值)，代表要顯示的元素索引。換句話說，所有能夠顯示 min <= index < max 的索引。

當 hAxis.viewWindowMode 為「漂亮」或「最大化」時，系統會忽略此值。

圖表的高度，以像素為單位。

如果設為 True，系統就會在每個網域值中堆疊所有序列的元素。 注意：在「Column」、「Area」和「SteppedArea」圖表中，Google 圖表會反向排序圖例項目的順序，使其與序列元素的堆疊更一致 (例如，0 系列是最底部的圖例項目)。這項「不」 適用於長條圖圖表。

isStacked 選項也支援 100% 堆疊，每個網域值的元素堆疊會經過重新縮放，總和為 100%。

isStacked 的選項如下：

• false：元素不會堆疊。這是預設選項。
• true：在各個網域值中堆疊所有序列的元素。
• 'percent'：針對每個網域值堆疊所有序列的元素並調整大小，使這些元素總和達到 100%，每個元素的值都算是 100% 的百分比。
• 'relative'：針對每個網域值堆疊所有序列的元素並調整大小，讓這些元素總和等於 1，而每個元素的值都以 1 的小數計算。
• 'absolute'：運作方式與 isStacked: true 相同。

如果是 100% 堆疊，每個元素的計算值會顯示在工具提示中的實際值之後。

根據預設，目標軸的刻度值是以相對 0-1 尺度為準，亦即 'relative' 的分數為 1，'percent' 為 0-100% (注意：使用 'percent' 選項時，軸/刻度值會以百分比顯示，但實際值是相對的 0-1 尺度值)。這是因為百分比軸刻點是套用「#.##%」的格式來搭配相對 0-1 尺度值的結果。使用 isStacked: 'percent' 時，請務必使用相對 0-1 縮放值指定任何刻點/格線。您可以使用適當的 hAxis/vAxis 選項自訂格線/刻點值和格式設定。

100% 堆疊僅支援 number 類型的資料值，且基準值必須為零。

由成員組成的物件，可設定圖例的各個層面。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

已為圖例預先選取零開始頁面索引。

圖例位置。可以是下列其中一項：

• 「bottom」- 圖表下方。
• 'left' - 在圖表左側，左軸沒有任何相關的序列。 因此，如果您想在左側放置圖例，請使用 targetAxisIndex: 1 選項。
• 「in」 - 圖表內部 (位於圖表左上角)。
• 「無」- 不顯示圖例。
• 「right」：圖表右側。與 vAxes 選項不相容。
• 「top」：圖表上方。

圖例的對齊。可以是下列其中一項：

• 「開始」：與為圖例分配的區域起點對齊。
• 「center」：以圖例的分配區域為中心。
• 「end」：與圖例的分配區域結尾對齊。

起點、中心和結束點是以圖例的樣式 (垂直或水平) 為準。舉例來說，在「右側」圖例中，「start」和「end」分別位於頂端和底部。如果是「頂端」圖例，「start」和「end」則分別位於區域的左側和右側。

預設值取決於圖例位置。「bottom」圖例的預設值為「center」，其他圖例則預設為「start」。

指定圖例文字樣式的物件。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

圖表方向。如果設為 'vertical'，系統會旋轉圖表的軸線，讓柱狀圖 (例如) 柱狀圖變為長條圖，而面積圖會向右成長而非向上：

如果設為 true，則是由右至左繪製序列。預設為從左到右繪製。

這個選項僅支援 discrete major 軸。

物件的陣列，每個物件都會說明圖表中對應序列的格式。如要使用時間序列的預設值，請指定空白物件 {}。如未指定序列或值，則會使用全域值。每個物件都支援下列屬性：

• annotations - 要套用至這個系列中註解的物件。舉例來說，這可用於控制系列的 textStyle，例如：

  series: {
    0: {
      annotations: {
        textStyle: {fontSize: 12, color: 'red' }
      }
    }
  }
            

  如需更完整的自訂項目清單，請參閱各種 annotations 選項。

• color - 此系列使用的顏色。指定有效的 HTML 顏色字串。
• targetAxisIndex：這個序列要指派到哪個軸，其中 0 為預設軸，1 為反軸。預設值為 0；設為 1 即可定義根據不同軸顯示不同序列的圖表。至少一個序列會分配給預設軸。您可以為不同軸定義不同的量表。
• visibleInLegend - 布林值，其中 true 代表序列應有圖例項目，而 false 則表示不應。預設值為 true。

您可以指定物件的陣列，其中每個陣列都會依指定順序套用至系列，或者您可以指定各子項一個數字鍵，代表要套用哪個序列。舉例來說，以下兩個宣告皆相同，並將第一個序列宣告為來自圖例，第 4 個是紅色且從圖例中消失：

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    

主題是一組預先定義的選項值，可搭配運作來達成特定圖表行為或視覺效果。目前只有一個主題：

• 「最大化」- 將圖表區域最大化，並在圖表區內繪製圖例和所有標籤。設定下列選項：

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

顯示在圖表上方的文字。

圖表標題的放置位置，與圖表區域比較。支援的值：

• in - 在圖表區域繪製標題。
• out - 在圖表區域外繪製標題。
• 無 - 省略標題。

指定標題文字樣式的物件。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

可讓成員設定各種工具提示元素的物件。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{textStyle: {color: '#FF0000'}, showColorCode: true}

如果設為 true，系統就會允許工具提示的繪圖，超出圖表任何邊的邊界。

注意：這僅適用於 HTML 工具提示。透過 SVG 工具提示啟用這項功能時，系統會裁剪圖表邊界外的所有溢位。詳情請參閱「自訂工具提示內容」一文。

如果設為 true，將使用 HTML 算繪 (而非 SVG 算繪) 的工具提示。詳情請參閱「自訂工具提示內容」一文。

注意：泡泡圖圖表「不」支援透過工具提示欄資料角色自訂 HTML 工具提示內容。

如為 true，則在工具提示中的系列資料旁邊顯示彩色方塊。在 focusTarget 設為「category」時，預設值為「true」，否則預設值為「false」。

指定工具提示文字樣式的物件。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

觸發工具提示的使用者互動：

• 「焦點」- 當使用者將遊標懸停在元素上時，就會顯示工具提示。
• 「無」- 不會顯示工具提示。
• 「selection」- 使用者選取元素時，系統會顯示工具提示。

在支援圖表的圖表中顯示 趨勢線 。根據預設，系統會使用線性趨勢線，但您可以使用 trendlines.n.type 選項自訂這個選項。

趨勢線是以個別系列為依據，因此您的選項在大部分時間看起來會像這樣：

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      showR2: true,
      visibleInLegend: true
    }
  }
}
    

趨勢線 的顏色，以英文顏色名稱或十六進位字串表示。

針對 type: 'polynomial' 的 趨勢線 ，多項式的程度 (2 代表二次方，3 代表立方體，以此類推)。(即將推出的 Google 圖表版本將預設等級從 3 變更為 2)。

設定後， 趨勢線 會以這個字串顯示在圖例中。

趨勢線 的線條寬度 (以像素為單位)。

趨勢線 的透明度，從 0.0 (透明) 到 1.0 (不透明)。

趨勢線 是指在圖表上戳出許多圓點；這個很少需要的選項可讓您自訂圓點的大小。趨勢線的 lineWidth 選項通常較為理想。不過，如果您使用全域 pointSize 選項，且希望趨勢線的點大小不同，就需要這個選項。

趨勢線 會在圖表中戳許多圓點。趨勢線的 pointsVisible 選項可決定是否要顯示特定趨勢線的資料點。

是否在圖例或趨勢線工具提示中顯示 決定係數 。

趨勢線 是否為 'linear' (預設)、'exponential' 或 'polynomial'。

是否在圖例中顯示 趨勢線 。(顯示在趨勢線的工具提示中)。

如果圖表有多個垂直軸，請指定個別垂直軸的屬性。每個子項物件都是 vAxis 物件，且可包含 vAxis 支援的所有屬性。這些屬性值會覆寫同一屬性的所有通用設定。

如要指定包含多個垂直軸的圖表，請先使用 series.targetAxisIndex 定義新軸，然後使用 vAxes 設定軸。以下範例會將序列 2 指派到右軸，並為該序列指定自訂標題和文字樣式：

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

這個屬性可以是物件或陣列：物件是物件的集合，每個物件都會有指定所定義軸的數值標籤，也就是上述格式；陣列是物件的陣列，每個軸代表一個物件。舉例來說，下列陣列樣式標記法與上述 vAxis 物件相同：

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    

包含成員的物件，可設定各種垂直軸元素。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

vAxis 屬性，指定縱軸的基準。如果基準大於最高格線大小或小於最低格線，系統會將基準線四捨五入至最接近的格線。

指定縱軸的基準顏色。可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。

垂直軸值成長的方向。根據預設，低值會顯示在圖表底部。指定 -1 將值的順序反轉。

數字軸標籤的格式字串。這是 ICU 模式集 的子集。舉例來說，{format:'#,###%'} 會針對值 10、7.5 及 0.5，顯示「1,000%」、「750%」和「50%」。您也可以提供下列任一項目：

• {format: 'none'}：顯示不含格式的數字 (例如8000000 顆)
• {format: 'decimal'}：顯示包含千位數分隔符的數字 (例如8,000,000 人)
• {format: 'scientific'}：以科學記號顯示數字 (例如8e6)。
• {format: 'currency'}：以當地幣別顯示數字 (例如$8,000,000.00 美元)
• {format: 'percent'}：以百分比顯示數字 (例如800,000,000%)
• {format: 'short'}：顯示縮寫數字 (例如800 萬)
• {format: 'long'}：將數字顯示為完整的字詞 (例如800 萬)

套用至標籤的實際格式是衍生自載入 API 時使用的語言代碼。詳情請參閱「 載入特定語言代碼的圖表 」。

計算刻點值和格線時，系統會考慮所有相關格線選項的幾種替代組合，如果格式化的刻點標籤重複或重疊，系統會拒絕替代組合。因此，如果您只想顯示整數刻點值，則可以指定 format:"#"，但請注意，如果沒有替代項目符合這項條件，系統就不會顯示格線或刻點。

包含成員用來設定縱軸格線的物件。請注意，垂直軸格線是水平繪製的。如要指定這個物件的屬性，您可以使用物件常值標記法，如下所示：

{color: '#333', minSpacing: 20}

圖表區域中的垂直格線顏色。指定有效的 HTML 顏色字串。

圖表區域中的水平格線約略數量。 如果為 gridlines.count 指定正數，系統會使用該數字計算格線之間的 minSpacing。 您可以將 1 值指定為只繪製一個格線，指定 0 值則可繪製不繪製格線。指定 -1 (此為預設值)，即可依據其他選項自動計算格線數量。

相鄰格線之間的大小陣列 (做為資料值，而非像素) 陣列。此選項目前只適用於數字軸，但類似於僅適用於日期和時間的 gridlines.units.<unit>.interval 選項。以線性比例來說，預設值為 [1, 2, 2.5, 5]，表示格線值可以採用每單位 (1)、偶數 (2)，或是 2.5 或 5 的倍數。這些值的 10 倍以上也會納入考量 (例如 [10, 20, 25, 50] 和 [.1, .2, .25, .5]。)對數尺標的預設值則為 [1, 2, 5]。

介於 hAxis 主要格線之間的最小螢幕空間 (以像素為單位)。 主要格線比例預設為 40，線性比例則預設為 20。如果指定 count 而非 minSpacing，系統會依據計數計算 minSpacing。相反地，如果您指定 minSpacing 而非 count，則計數會從 minSpacing 計算得出。如果您同時指定兩者，系統會覆寫 minSpacing。

所有格線值和刻度值都必須是這個選項值的倍數。請注意，與間隔不同，10 倍的次方不會考量倍數。因此，您可以指定 gridlines.multiple = 1，將滴答強制設為整數，或者指定 gridlines.multiple = 1000，強制滴答是 1000 的倍數。

將日期/日期時間/時間資料類型與圖表計算的格線搭配使用時，覆寫預設格式。允許格式化年、月、日、小時、分鐘、秒鐘和毫秒。

一般格式為：

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]},
    hours: {format: [/*format strings here*/]},
    minutes: {format: [/*format strings here*/]},
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]}
  }
}
    

詳情請參閱日期和時間。

此物件可讓成員在垂直軸上設定次要格線，與 vAxis.gridlines 選項類似。

圖表區域中的垂直小格線顏色。指定有效的 HTML 顏色字串。

「orGridlines.count」選項主要已淘汰，除非將計數設為 0 以停用次要格線。次要格線的數量取決於主要格線之間的間隔 (請參閱 vAxis.gridlines.interval) 與最低所需空間 (請參閱 vAxis.minorGridlines.minSpacing)。

小 Gridlines.interval 選項與主要格線間隔選項類似，但所選的間隔一律為主要格線間隔的偶數除數。線性比例的預設時間間隔為 [1, 1.5, 2, 2.5, 5]，對數尺度的預設間隔為 [1, 2, 5]。

相鄰次要格線之間，以及小型和主要格線之間至少需要的空間 (以像素為單位)。以線性比例尺度來說，主要格線的 minSpacing 為 1/2，對對數比例而言則為 minSpacing 為 1/5。

與主要 gridlines.multiple 相同。

與計算的次要格線搭配使用時，覆寫日期/日期時間/時間資料類型各個面向的預設格式。允許格式化年、月、日、小時、分鐘、秒鐘和毫秒。

一般格式為：

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

詳情請參閱日期和時間。

如果設為 true，系統會將垂直軸設為對數尺度。注意：所有值都必須為正數。

vAxis 屬性，讓垂直軸成為對數尺度。可以是下列任一值：

• null - 不執行對數縮放。
• 「log」：對數縮放。系統不會繪製負值和零的值。這個選項與設定 vAxis: { logscale: true } 相同。
• 「MirrorLog」：繪製負值和零的對數進行對數縮放。負數的繪製值是絕對值記錄檔的負數。接近 0 的值會以線性比例繪製。

這個選項僅適用於 continuous 軸。

垂直軸文字相對於圖表區域的位置。支援的值：「out」、「in」、「none」。

指定縱軸文字樣式的物件。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

將自動產生的 Y 軸刻點替換為指定陣列。陣列的每個元素應為有效的刻點值 (例如數字、日期、時間或時間) 或物件。如果是物件，則應提供用於刻點值的 v 屬性，以及選用的 f 屬性，其中含有要顯示為標籤的常值字串。

除非您指定要覆寫的 viewWindow.min 或 viewWindow.max，否則 viewWindow 會自動展開以包含最小和最大滴答。

例：

• vAxis: { ticks: [5,10,15,20] }
• vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

vAxis 屬性，指定縱軸的標題。

指定縱軸標題文字樣式的物件。物件的格式如下：

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

color 可以是任何 HTML 顏色字串，例如 'red' 或 '#00cc00'。另請參閱 fontName 和 fontSize。

將垂直軸的最大值移至指定值；在大部分的圖表中，這個值會向上移動。如果設為值小於資料的最大 y 值，系統會忽略這項設定。 vAxis.viewWindow.max 會覆寫這項屬性。

將垂直軸的最小值移至指定值；在多數圖表中，這個值會向下移動。如果設定的值大於資料最小 y 值，則系統會忽略這項設定。 vAxis.viewWindow.min 會覆寫這項屬性。

指定如何縮放縱軸，以轉譯圖表區域中的值。支援的字串值如下：

• 「漂亮」- 縮放垂直值，讓最大和最小值在圖表區域底部和頂端顯示一點。ViewWindow 會展開為最接近的數字主要格線，或找出最接近日期和時間的次要格線。
• 「maximized」- 縮放垂直值，讓最大值和最小值觸及圖表區域的頂端和底部。這項操作會忽略 vaxis.viewWindow.min 和 vaxis.viewWindow.max。
• 「explicit」：已淘汰指定圖表區域頂部和底部縮放值的選項。(已淘汰，因為 vaxis.viewWindow.min 和 vaxis.viewWindow.max 是多餘的)。系統會裁剪超出這些值的資料值。您必須指定 vAxis.viewWindow 物件，說明要顯示的最大值和最小值。

指定垂直軸的裁剪範圍。

要顯示的最大垂直資料值。

當 vAxis.viewWindowMode 為「漂亮」或「最大化」時，系統會忽略此值。

要顯示的垂直資料最小值。

當 vAxis.viewWindowMode 為「漂亮」或「最大化」時，系統會忽略此值。

圖表的寬度，以像素為單位。

繪製圖表。只有在觸發 ready 事件後，圖表才能接受其他方法呼叫。Extended description。

傳回含有要求的 actionID 的工具提示動作物件。

傳回包含圖表元素 id 左側、頂端、寬度和高度的物件。尚未記錄 id 的格式 (這些是事件處理常式的傳回值)，但以下提供一些範例：

var cli = chart.getChartLayoutInterface();

圖表區域的高度

cli.getBoundingBox('chartarea').height

長條圖第一連串的第三條長條寬度

cli.getBoundingBox('bar#0#2').width

圓餅圖第五個楔形的定界框

cli.getBoundingBox('slice#4')

垂直 (例如柱狀圖) 圖表資料的定界框：

cli.getBoundingBox('vAxis#0#gridline')

水平 (例如長條圖) 的圖表資料定界框：

cli.getBoundingBox('hAxis#0#gridline')

值是相對於圖表容器的值。請在繪製圖表「之後」呼叫此動作。

傳回包含圖表內容左側、頂端、寬度和高度的物件 (即不含標籤和圖例)：

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

值是相對於圖表容器的值。請在繪製圖表「之後」呼叫此動作。

傳回包含圖表在螢幕上位置相關資訊的物件，以及其元素。

以下方法可在傳回的物件上呼叫：

• getBoundingBox
• getChartAreaBoundingBox
• getHAxisValue
• getVAxisValue
• getXLocation
• getYLocation

請在繪製圖表「之後」呼叫此動作。

傳回 xPosition 的水平資料值，該值是與圖表容器左側邊緣的像素偏移值。可以是負數。

範例：chart.getChartLayoutInterface().getHAxisValue(400)。

請在繪製圖表「之後」呼叫此動作。

傳回已序列化為圖片 URI 的圖表。

請在繪製圖表「之後」呼叫此動作。

請參閱列印 PNG 圖表。

傳回所選圖表實體的陣列。 可選取的實體包括長條圖、圖例項目和類別。 長條對應資料表中的儲存格、資料欄的圖例項目 (資料列索引為空值)，以及資料列的類別 (欄索引為空值)。 在這張圖表中，無論何時都只能選取一個實體。 Extended description 。

傳回位於 yPosition 的垂直資料值，該值為與圖表容器頂部邊緣往下的像素偏移。可以是負數。

範例：chart.getChartLayoutInterface().getVAxisValue(300)。

請在繪製圖表「之後」呼叫此動作。

傳回相對於圖表容器左側邊緣的 dataValue 像素 X 座標。

範例：chart.getChartLayoutInterface().getXLocation(400)。

請在繪製圖表「之後」呼叫此動作。

傳回相對於圖表容器頂部邊緣的 dataValue 像素 y 座標。

範例：chart.getChartLayoutInterface().getYLocation(300)。

請在繪製圖表「之後」呼叫此動作。

從圖表中移除要求 actionID 的工具提示動作。

設定在使用者點選動作文字時執行的工具提示動作。

setAction 方法會將物件做為動作參數。這個物件應指定 3 個屬性：id (所設定動作的 ID)、text (應顯示在動作工具提示中的文字) 和 action (使用者按一下動作文字時應執行的函式)。

請在呼叫圖表的 draw() 方法之前，設定所有及所有工具提示動作。延伸說明。

選取指定的圖表實體。取消先前選取的任何項目。 可選取的實體包括長條圖、圖例項目和類別。 長條對應資料表中的儲存格、資料欄的圖例項目 (資料列索引為空值)，以及資料列的類別 (欄索引為空值)。 在這張圖表中，一次只能選取一個實體。 Extended description 。

清除圖表並釋出所有分配的資源。

轉場動畫播放完畢時觸發。

使用者點選圖表內時觸發。可用於識別使用者點選標題、資料元素、圖例項目、軸、格線或標籤的時機。

嘗試算繪圖表時發生錯誤時觸發。

使用者按一下圖例分頁箭頭時觸發。傳回目前從零開始計算的圖例索引和總頁數。

在使用者將滑鼠遊標懸停在視覺實體上時觸發。回傳對應資料表元素的列和欄索引。

在使用者滑鼠遊標移離視覺實體時觸發。傳回對應資料表元素的列和欄索引。

圖表已可供外部方法呼叫。如果您想與圖表互動，並在繪製後呼叫方法，您應「先」設定此事件的事件監聽器，並只在事件觸發後才呼叫這些事件。draw

在使用者點選視覺實體時觸發。如要瞭解已選取的項目，請呼叫 getSelection()。