長條圖

   

本文件說明您可以使用 Chart API 建立的各種長條圖類型。

目錄

圖表專屬功能

  1. 總覽
  2. 圖表類型 (cht)
  3. 序列顏色 (chco)
  4. 長條圖標籤
  5. 長條寬度和間距 (chbh)
  6. 零行 (chp)
  7. 複合圖表
  8. 特定長條的標記

標準功能

  1. 圖表標題 (chtt、chts)
  2. 圖表圖例文字和樣式 (chdl、chdlp、chdls)
  3. 圖表利潤 (chma)
  4. 軸樣式和標籤
    1. 可見軸 (chxt)
    2. 軸範圍 (chxr)
    3. 自訂軸標籤 (chxl)
    4. 軸標籤位置 (chxp)
    5. 軸標籤樣式 (chxs)
    6. 軸線標記 (chxtc)
  5. 背景填滿 (chf)
    1. 恆亮填滿 (chf)
    2. 漸層填滿 (chf)
    3. 條紋填滿 (chf)
  6. 格線 (chg)
  7. 動態標記 (chem)
  8. 形狀標記 (chm)
  9. 文字和資料值標記 (chm)
  10. 範圍標記 (chm=r|R)
  11. K 線標記 (chm=F)
  12. 線條標記 (chm=D)
  13. 資料函式 (chfd)

總覽

您可以建立各種長條圖，包括垂直、水平、分組、堆疊和重疊版本。

長條圖適合並排比較，也能在少量不同的資料點中找出趨勢。如果您的序列只有幾個資料點，建議使用折線圖。

長條圖中通常有三種顯示多個序列的方法：

已分組
已堆疊
重疊
已分組的圖表
堆疊圖
重疊的圖表
cht=bvg
chd=t:5,5,5|10,10,10|15,15,15		 cht=bvs
chd=t:5,5,5|10,10,10|15,15,15
 cht=bvo
chd=t:5,5,5|10,10,10|15,15,15

您可以使用 chbh 參數控制長條的寬度和間距。如未指定 chbh，系統可能會裁剪部分長條。

請注意，根據預設，所有序列都會以相同的顏色顯示。如果您未為不同的序列指定不同的顏色，將會難以區分圖表中有多個序列。詳情請參閱「系列顏色」。

根據預設，長條圖至少會顯示一個軸；如要隱藏任何預設軸，請使用chxs參數並指定底線axis_or_tick>。

如果您在堆疊圖表中使用簡易文字格式，請留意除非您新增自訂縮放功能，否則圖表會將超過 100 的任何內容裁剪為堆疊總高度，如下所示：

在沒有縮放的情況下，中間三條長條超過 100 個，在簡易的文字格式資料圖表中被裁剪。 水平長條圖和兩個資料集：其中一個資料集以深藍色堆疊，並疊成了淡藍色
cht=bhs
chco=4D89F9,C6D9FD
chd=t:10,50,60,80,40|
  50,60,100,40,20
如果您想顯示完整堆疊長條長度，則必須使用其他編碼配置，或採用具有自訂縮放比例的文字格式設定。最大比例值應與堆疊長條高度相對；此例最多為 160 (總和)。 水平長條圖和兩個資料集：其中一個資料集以深藍色堆疊，並疊成了淡藍色
cht=bhs
chco=4D89F9,C6D9FD
chd=t:10,50,60,80,40|
  50,60,100,40,20
chds=0,160

圖表類型 (cht)

您可以使用幾種不同的長條圖建立長條圖。請使用以下語法指定長條圖：

語法

cht=<chart_type>

其中 <chart_type> 是以下其中一種類型：

圖表類型 說明 範例

bhs

含有堆疊長條圖的水平長條圖。

第一個範例 (所有深藍色長條) 都有一個資料序列。

第二個範例 (深色和淺藍色的長條) 有兩個序列。(系統也會縮放以顯示超過 100 的加總長條值)。

如您所見，多套系列叢書會堆疊顯示。如未指定不同的系列顏色，所有顏色都會相同 (而且長條不會堆疊)。也可以為單一系列中的各個長條指定顏色。

水平長條圖與兩個資料集：兩個資料集都顯示為藍色
cht=bhs
chco=4D89F9

水平長條圖和兩個資料集：其中一個資料集以深藍色堆疊，並疊成了淡藍色
cht=bhs
chco=4D89F9,C6D9FD
chd=t:10,50,60,80,40|
  50,60,100,40,20
chds=0,160

bvs

垂直長條圖與堆疊長條。

本範例包含兩個系列，並使用文字格式搭配自訂縮放功能，確保所有堆疊值都能完整顯示。

請注意，如果您使用 chp 參數移動 bvs 圖表中的零線，當長條小於這個值時，數值會顯示在零線下方；如果大於這個值，就會顯示為大於這個值。

包含兩個資料集的垂直長條圖：其中一組資料集以深藍色堆疊，並堆疊為淡藍色cht=bvs
chco=4D89F9,C6D9FD
chd=t:10,50,60,80,40|
  50,60,100,40,20
chds=0,160
bvo 長條堆疊的堆疊方式，而非彼此上方。每個長條的高度皆為個別值，而非總和。長條會依高度排序，以便顯示所有長條。

折疊圖
cht=bvo
chd=t:
  10,50,60,80,40
  50,60,100,40,20
  30,30,75,20,60

bhg

水平長條圖和已分組的長條。

上方圖表使用預設的群組間距值；底部圖表使用 chbh 參數修改預設長條寬度和群組間距，讓群組更明顯。

水平長條圖和兩個資料集：一個資料集以深藍色標示，另一部分以淺藍色相鄰
cht=bhg
chco=4D89D9,C6D9FD

水平長條圖和兩個資料集：一個資料集以深藍色標示，另一部分以淺藍色相鄰
cht=bhg
chco=4D89D9,C6D9FD
chbh=15,4,15

bvg

垂直長條圖與已分組的長條圖。

包含兩個資料集的垂直長條圖：一個資料集以深藍色顯示，第二個以淺藍色相鄰
cht=bvg
chco=4D89F9,C6D9FD
chbh=15,4,15

返回頁首

序列顏色 chco

您可以使用 chco 參數指定個別長條、個別序列或多個序列的顏色。如未為各個系列叢書指定不同的顏色，所有系列叢書都會使用相同顏色。

語法

chco=<series_1_color>, ..., <series_n_color>

    or

chco=<series_1_bar_1>|<series_1_bar_2>|...|<series_1_bar_n>,<series_2>,...,<series_n>
<color>
套用至序列或個別長條的 RRGGBB 格式十六進位數字。如要將顏色套用至整個系列，請以半形逗號分隔。如要將顏色套用至個別長條，應以直立線分隔。您可以混用這兩種格式。請參閱下表的範例。只要顏色值少於資料點或序列的數量，顏色就會從該群組的第一個顏色開始循環顯示。

 

例子

說明 範例
每個系列採用一個顏色，以半形逗號分隔顏色。

包含兩個資料集的垂直長條圖：其中一組資料集以深藍色堆疊，並堆疊為淡藍色

cht=bvs
chco=4D89F9,C6D9FD
每個值一個顏色，以直立線符號分隔的顏色。

包含兩個資料集的垂直長條圖：其中一組資料集以深藍色堆疊，並堆疊為淡藍色

cht=bvs
chco=FFC6A5|FFFF42|DEF3BD|00A5C6|DEBDDE

一系列顏色和個別長條顏色的組合。

這個範例顯示包含兩個序列的長條圖。第一個系列全黑色 (000000,) 和以半形逗號分隔。 第二個序列是以直立線分隔，並為每個點 (FF0000|00FF00|0000FF) 指派不同的顏色。

水平長條圖，有一個資料點以紅色標示，第二個是綠色，第三個是藍色的

chco=000000,FF0000|00FF00|0000FF
chd=s:FOE,elo
這個範例說明如何為多系列圖表中的每個長條設定不同顏色。 水平長條圖，有一個資料點以紅色標示，第二個是綠色，第三個是藍色的
chco=
  FF0000|00FF00|0000FF,FFC6A5|DEF3BD|C6EFF7
您也可以指定以單色、條紋或漸層色彩為序列著色的填滿效果。純填滿效果與使用 chco 時相同，但線條或漸層會帶來獨特的效果。 漸層長條填滿
chd=
  t:10,40,60,80,30,20
chf=
  b0,lg,0,FFE7C6,0,76A4FB,1
條紋填色
chd=t:
  40,40,60,80
  30,50,55,86
chf=
  b0,ls,0,FFE7C6,.3,76A4FB,.1
  b1,ls,0,FF0000,.3,FFBFBF,.1

返回頁首

長條圖標籤

長條圖支援標準軸標籤，但長條底的標籤會指派給個別長條，而非沿著長條圖分散。(如要平均分散標籤，請使用下方所述的 chxp 參數)。如果您指定了軸標籤，但沒有在長條軸上指定自訂標籤，則長條標籤將是每個長條或長條的索引編號。您可以使用 chxl 參數自訂軸標籤。

說明 範例
使用預設 X 軸標籤的長條圖。 不含自訂標籤的長條圖
chxt=x,y
使用自訂 X 軸標籤的長條圖。

不含自訂標籤的長條圖
chxt=x,y
chxl=0:|Jan|Feb|Mar|Apr|May

如果您有多個標籤和長條，且想要平均間距 (而非每個長條下方)，請使用 chxp 參數搭配 <axis_index>,0 語法，其中 axis_index 是要加上標籤的軸索引，0 則代表應平均間隔。(這是因為單一 0 代表第一個標籤的位置，而且沒有其他值也代表標籤應自動在軸上平均放置)。

  • 頂端圖表：每五長條套用三個圖表標籤，標籤會在前三條長條下方對齊。
  • 底部圖表：相同的三個標籤套用至五個長條，但 chxp=0,0 會使標籤在 X 軸 (軸索引 0) 上平均間隔。

不含自訂標籤的長條圖
chd=s:cEj9U
chxt=x,y
chxl=0:|2001|2002|2003

不含自訂標籤的長條圖
chd=s:cEj9U
chxt=x,y
chxl=0:|2001|2002|2003
chxp=0,0

返回頁首

長條寬度和間距 chbh

您可以選擇指定自訂長條的寬度值，以及長條和群組之間的間距。您只能為所有長條指定一組寬度值。如未指定 chbh，所有長條的寬度都會是 23 像素，這表示如果總長條寬度超過圖表寬度，結束長條就能剪裁。

語法

chbh=
  <bar_width_or_scale>,<space_between_bars>,<space_between_groups>
<bar_width_or_scale>
長條的寬度。只要輸入下列其中一個值，即可以絕對或相對的方式指定寬度和間距。預設值為 23 像素，絕對值。
  • width - 長條寬度 (以像素為單位)。所有間距值也是絕對值，以像素為單位。如果圖表寬度不足，系統可能會裁剪長條。
  • a：space_between_bars 和 space_between_groups 均以絕對單位表示 (如果未指定，則指定預設的絕對值)。系統會調整長條的大小，以便讓所有長條顯示在圖表中。
  • r - space_between_bars 和 space_between_groups 是以相對單位 (或預設相對值，如未指定) 表示，相對單位是與列寬度相較的浮點值，其中列寬度為 1.0：例如 0.5 是長條寬度的兩倍，2.0 則是長條寬度的兩倍。如果圖表寬度不足，系統可能會裁剪長條。
<space_between_bars>
[選用] 相同群組中的長條之間空格。如果調整大小為絕對大小，則是指寬度 (以像素為單位)。如果調整大小是相對的，則這會是一個浮點值，其中 1.0 代表長條寬度。絕對值的預設值為 4 像素，相對值則為 4/23。
<space_between_groups>
[選用] 同一群組中長條群組之間的空格。如果尺寸為絕對大小，這個值會以像素為單位。如果調整大小為相對，則這會成為浮點值，其中 1.0 為長條寬度。絕對值的預設值為 8 像素，相對值則為 8/23。

中間選用參數無法省略，必須結尾為指定值。例如：chbh=10,5,10 有效、chbh=10,,10 無效，chbh=10,5, 則無效。

說明 範例

這張圖表使用 a 值自動調整值的大小。

第一張圖表沒有群組間距，因此群組不會顯示。第二個圖表會在群組之間加入一些間距 (15 像素)。

以藍色和黑色垂直分組的長條圖，自動調整長條和空格的大小

chbh=a



chbh=a,5,15

此圖表使用 r 值來指定相對於長條寬度的大小。在這張圖表中，長條之間的間距為長條寬度 0.5 倍，群組寬度則為 1.5 倍長條寬度。

垂直分組的藍色/黑色長條圖，長條會自動調整大小，並以圖表寬度百分比表示空格

chbh=r,0.5,1.5

第一個圖表在每個序列中都有五個值，但圖表太小，無法容納所有包含預設值的長條：

10 * 長條 23 像素 +
5 * 4 像素 (間距) +
4 * 8 像素 (群組間距)                         
282 像素 -- 超過 190 像素的像素圖表寬度

...所以有些長條會切割

第二張圖表會指定絕對長條和間距值，以符合圖表中的所有長條。

以藍色和黑色垂直分組的長條圖，長條圖預設寬度

chbh略過
chs=190x125
兩個系列，五個值/系列

以藍色和黑色垂直分組的長條圖，自動調整長條的大小

chbh=10,5,10

返回頁首

零行 chp

您可以使用 chp 參數或搭配資料縮放功能使用文字編碼，為圖表指定自訂的零線。這些零行會以兩種不同方式運作：

  • 資料縮放 - 使用文字格式資料時，搭配縮放參數 chds 時，系統會視需要向上推移零行以顯示所有負值。
  • chp 參數 - 您也可以用 chp 參數，以任何資料格式手動將零行移至任何位置。這樣做實際上會建立人工零線條，然後重新繪製長條，做為資料值與任意零值之間的差 (也就是長條會從零線繪製到長條值)。無法與 chds 合併使用。

語法

chp=
  <zero_value_series_1>,
   ...,
  <zero_value_series_n>
<zero_value_series_1>
介於 0.0 到 1.0 (含) 之間的浮點值，0.0 是軸底部，而 1.0 位於軸頂點。系統會重新繪製長條，以顯示這個值與其值之間的差異。
說明 範例

以下是包含相同資料的三張長條圖副本：

  • 第一張顯示未指定零行的圖表。
  • 第二個顯示零線為 0.2 的圖表，或將零線向左推到 Y 軸上距離的 0.2。請注意，值 20 因為位於新的零行，所以已經消失。
  • 第三個圖表顯示零行 0.5。現在 20 個值會重新顯示為負值，與 40 個值 (小於 50) 相同。這是因為長條是從新的零線位置繪製到實際資料值，因此圖表中小於 50 的值向下會下降，且大於 50 的值會向上繪製。

垂直長條圖，向上排列至圖表上半線
chd=t:20,40,60,80,95
未指定零行。

垂直長條圖，向上排列至圖表上半線
chd=t:20,40,60,80,95
chp=0.2

垂直長條圖，向上排列至圖表上半線
chd=t:20,40,60,80,95
chp=0.5

這個範例說明如何使用文字格式化資料搭配自訂縮放 (chds)，以設定零行。您無法同時使用 chds 和 chp。

範例的值介於 -60 到 120 之間。比例會設為 -80 至 140，讓長條的上方和下方留有空間。

 水平長條圖包含兩個資料集：兩個資料集都以紅色顯示
chd=t:30,-60,50,120,80
chds=-80,140

返回頁首

複合圖表

您可以在長條圖中加入線條、K 線圖和形狀標記，製作複合圖表。詳情請參閱複合圖表。

特定長條的標記 (僅限 cht=bvg)

根據預設，當您在分組垂直圖表上繪製 chm 標記時，標記會繪製在擷取其資料的同一系列上。如果資料是隱藏的序列，預設行為是將標記置於長條群組中央。

不過，使用垂直分組的長條圖 (類型 bvg) 時，您可以指定與標記資料序列不同的刊登位置序列。方法是使用下列語法指定 <series_index> 參數 (第三個參數)：<data_series_index>:<placement_series_index>。

請注意，如果您指定隱藏或不存在的 placement 系列，標記會在群組內水平置中。

如要使用此功能，最佳做法是使用一個隱藏的序列標記標記資料，並將標記放在可見的序列上。

以下範例說明預設行為，資料序列和刊登位置序列均相同，以及進階語法來指定不同的資料和刊登位置序列。

隱藏的資料序列、預設標記位置 隱藏資料序列、進階標記位置

chd=t2: // First two series are visible
  10,20,30,40,50  // Red bars
  20,40,60,80,100 // Blue bars
  20,20,20,20,20  // Hidden: black circle data
  30,30,30,30,30  // Hidden: black square data
chm=
  o,000000,2,,10 // Circle markers
  s,000000,3,,10 // Square markers

在這個範例中，基本語法指定標記資料和位置應位於同一個系列中。由於這是隱藏的系列叢書，預設刊登位置會垂直置中於每個群組。

chd=t2: // First two series are visible
  10,20,30,40,50  // Red bars
  20,40,60,80,100 // Blue bars
  20,20,20,20,20  // Hidden: black circle data
  30,30,30,30,30  // Hidden: black square data
chm=
  o,000000,2:0,,10 // Circle markers
  o,000000,3:1,,10 // Square markers

在這個範例中，進階語法會為標記指定不同的資料來源和位置序列。圓形使用隱藏的第 2 層資料，排在第 0 序列中；正方形會使用隱藏序列 3 的資料，最後排在第 1 序列中。

以下範例說明如何在已分組的長條圖中，將數個不同的標記類型新增至個別的長條。請注意，黑色圓圈將隱藏的序列指定為刊登位置系列，因此顯示在群組的中心點。


chd=t4: // First four series are rendered as bars. Remaining data is hidden.
  5,10,15,20,25,30   // Purple bar
  10,20,30,40,50,60  // Blue bar
  30,40,50,60,70,80  // Olive bar
  5,5,5,5,5,5        // Black bar
  0,15,25,30,45,55   // Hidden data: Purple circle, blue error bar start
  15,30,40,45,55,65  // Hidden data: Blue error bar end
  20,35,45,50,55,65  // Hidden data: Yellow error bar start
  40,45,55,80,75,85  // Hidden data: Yellow error bar end
chm=                 // Markers:
  o,D000D0,4:0,,10   // Purple circle: data series 4, placement series 0 (purple)
  E,00D0D0,4:1,,1:10 // Blue error bars: data series 4, placement series 1 (blue)
  E,D0D000,6:2,,1:10 // Yellow error bars: data series 6, placement series 2 (olive)
  o,000000,3:4,,10   // Black circle: data series 3, placement 4 (hidden placement series, centered in group)

返回頁首

標準功能

本頁其餘功能是標準圖片圖表功能。

圖表標題 chtt，chts [所有圖表]

您可以指定圖表的標題文字、顏色和字型大小。

語法

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt：指定圖表標題。

<chart_title>
要在圖表中顯示的標題。您無法指定這個部分顯示的位置，但可以選擇指定字型大小和顏色。請使用 + 符號代表空格，並以直立線字元 ( |) 表示換行。

 

chts [選用]：chtt 參數的顏色和字型大小。

<color>
標題顏色，採用 RRGGBB 十六進位格式。預設顏色為黑色。
<font_size>
標題的字型大小，以點為單位。
<opt_alignment>
[選用] 標題對齊方式。請選擇下列其中一個區分大小寫的字串值：「l」(左側)、「c」(置中)「r」(右側)。預設值為「c」。

 

例子

說明 範例

包含標題的圖表，使用預設顏色和字型大小。

請使用加號 (+) 指定空格。

使用直立線字元 (|) 強制換行。

此處並未指定「chts」。

 含有標題的垂直長條圖
chtt=Site+visitors+by+month|
January+to+July

此圖表顯示藍色、靠右對齊且有 20 點的標題。

 有藍色、20 像素、標題的垂直長條圖
chtt=Site+visitors
chts=FF0000,20,r

返回頁首

圖表圖例文字和樣式 chdl、chdlp、chdls [所有圖表]

圖表的側邊部分會顯示每個序列的簡短文字說明。您可以指定與這個圖例中與每個序列相關聯的文字，並指定圖例在圖表中顯示的位置。

另請參閱 chma，瞭解如何設定圖例周圍的邊界。

字串值的注意事項：標籤字串只能使用安全網址字元。為了安全起見，如果字串包含非字元集 0-9a-zA-Z 中的字元，您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。

語法

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - 每個序列的文字，會顯示在圖例中。

<data_series_label>
圖例項目的文字。每個標籤都會套用至 chd 陣列中的對應系列。使用「+」符號代表聊天室。如未指定這個參數，圖表將不會取得圖例。您無法在標籤中指定換行符號。圖例通常會展開，以顯示圖例文字，而圖表區域則會縮小以容納圖例。

chdlp - [選用] 圖例的位置和圖例項目的順序。您可以指定 <position> 和/或 <label_order>。如果您同時指定兩者，請以長條字元分隔。如要讓圖例略過 chdl 中的空白圖例項目，您可以將「s」加到任何值。範例：chdlp=bv、chdlp=r、chdlp=bv|r、chdlp=bvs|r

<opt_position>
[選用] 指定圖例在圖表中的位置。如要指定圖例與圖表區域或圖片邊框之間的其他邊框間距，請使用 chma 參數。 選擇下列其中一個值：
  • b - 圖表底部的圖例，以水平列顯示圖例項目。
  • bv - 圖表底部的圖例，垂直欄中的圖例項目。
  • t - 圖表頂端的圖例，水平列中顯示圖例項目。
  • tv - 圖表頂端的圖例，垂直欄中的圖例項目。
  • r - [預設] 圖表右側的圖例，垂直欄中的圖例項目。
  • l - 圖表左側的圖例，垂直欄中的圖例項目。
<opt_label_order>
[選用] 標籤在圖例中的顯示順序。 選擇下列其中一個值：
  • l - [產業圖例的預設值] 依指定 chdl 的順序顯示標籤。
  • r - 根據 chdl 指定的順序，以反向順序顯示標籤。在堆疊長條圖中，這很實用，可以按照長條的顯示順序
    顯示圖例。
  • a - [水平圖例的預設值] 自動排序：大致表示依長度，從短到長排序，以 10 個像素區塊進行測量。如果兩個元素的長度相同 (分割為 10 個像素區塊)，系統會優先顯示第一個元素。
  • 0,1,2... - 自訂標籤順序。這份清單包含從 chdl 開始，以零為基準的標籤索引，並以半形逗號分隔。

chdls - [選用] 指定圖例文字的顏色和字型大小。

<color>
圖例文字顏色，採用 RRGGBB 十六進位格式。
<size>
圖例文字的點大小。

 

例子

說明 範例

請參閱兩個圖例範例。請按照資料序列的順序指定圖例文字。

紅、藍和綠折線圖中含有相符圖例

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

由兩個小型圓形圍成較大圓的文氏圖


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

第一張圖表展示水平圖例項目 (chdlp=t，預設版面配置為水平)，第二張圖表則示範底部垂直圖例項目 (chdlp=bv)。

由兩個小型圓形圍成較大圓的文氏圖
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t

由兩個小型圓形圍成較大圓的文氏圖
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv
這個範例說明如何變更字型大小。

由兩個小型圓形圍成較大圓的文氏圖
chdls=0000CC,14

返回頁首

圖表利潤 chma [所有圖表]

您可以用像素指定圖表邊界的大小。邊界是根據指定圖表大小 (chs) 進行計算；增加邊界大小不會增加圖表總大小，而是會在必要時縮小圖表區域。

根據預設，邊界為計算圖表大小後剩餘的內容。 這個預設值會因圖表類型而異。您指定的邊界為「最小值」；如果圖表區域保留空間空間，邊界大小會是剩餘的內容；您無法擠壓小於任何圖例和標籤所需範圍的邊界。下圖顯示圖表的基本部分：

圖表邊界、圖例區域和圖表區域

「圖表邊界」包括「軸標籤」和「圖例區域」。除非您使用 chma 指定更大的寬度，否則圖例區域會自動擴大範圍，將圖表區域縮小。您無法指定太小的圖例來裁剪，但可以佔用超過所需空間。

提示：在長條圖中，如果長條的尺寸固定 (預設值)，就無法縮減圖表區域寬度。您必須使用 chbh 指定較小或可調整大小的長條大小。

 

語法

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>、<right_margin>、<top_margin>、<bottom_margin>
圖表區域周圍的最小邊界大小 (以像素為單位)。增加這個值即可加入一些邊框間距，以免軸標籤與圖表邊界發生衝突。
<opt_legend_width>、 <opt_legend_height>
[選用] 圖例周圍的寬度，以像素為單位。這樣可以避免圖例出現在圖表區域或圖片邊緣上。

 

例子

說明 範例

在這個範例中，圖表兩側的邊界至少為 30 像素。由於圖表圖例寬度超過 30 像素，因此右側邊界會設為圖表圖例的寬度，與其他邊界不同。

軸標籤位於繪製區域之外，因此會在邊界空間中繪製。

折線圖的兩側有灰色背景和邊界。
chma=30,30,30,30

如要在圖例周圍新增邊界，請設定 <opt_legend_width> 和 <opt_legend_height> 參數的值。

在這個範例中，圖例的寬度約為 60 像素。如果您將 <opt_legend_width> 設為 80 像素，邊界會擴大至圖例外的 20 像素。

折線圖的兩側有灰色背景和邊界。
chma=20,20,20,30|80,20

返回頁首

軸樣式和標籤 [Line, Bar, Google-o-meter, Radar, Scatter]

您可以指定要在圖表上顯示哪些軸，也可以為其自訂標籤、位置、範圍和樣式。

並非所有圖表預設顯示軸線。你可以使用 chxt 參數，精確指定圖表應顯示哪些軸。預設軸線不會顯示數字；您必須在 chxt 參數中指定軸才能顯示數字。

您可以選擇讓軸顯示代表資料值的數字，也可以指定自訂軸。預設值為顯示數值，且值會縮放為 0 至 100 之間的數值。不過，您可以使用 chxr 變更該範圍以顯示任何範圍，也可以使用 chxs 設定值的樣式 (例如顯示貨幣符號或小數位數)。

如果您選擇使用自訂值 (例如「Mon, Tues, Wed」)，也可以使用 chxl 參數。如要將這些標籤沿著軸線的特定位置放置，請使用 chxp 參數。

最後，您可以使用 chxs 和 chxtc 參數，指定自訂和數值軸標籤的顏色、大小、對齊方式和其他屬性。

字串值的注意事項：標籤字串只能使用安全網址字元。為了安全起見，如果字串包含非字元集 0-9a-zA-Z 中的字元，您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。

本節涵蓋下列主題：

可見軸 chxt

根據預設，長條圖、折線圖、雷達圖和散佈圖會顯示一或兩條軸線，但這幾行不包含值。如要在軸線上顯示值或變更顯示的軸，您必須使用 chxt 參數。根據預設，除非您使用 chxr 屬性明確縮放軸值，否則軸值的範圍為 0 到 100。如要隱藏折線圖中的所有軸線，請在 cht 參數中的圖表類型值後方指定 :nda (例如：cht=lc:nda)。

根據預設，頂端和底部軸不會依數值顯示勾號，左右軸則會顯示勾號。您可以使用 chxs 參數變更這項行為。

語法

chxt=
  <axis_1>
    ,...,
  <axis_n>
<axis>
要在圖表中顯示的軸。可用的軸如下：
  • x - 底部 X 軸
  • t - 頂端 X 軸 [Google-o-Meter 不支援]
  • y - 左 Y 軸
  • r - 右側 Y 軸 [Google-o-Meter 不支援]

您可以指定多個相同類型的軸，例如：cht=x,x,y。這會沿著圖表底部堆疊兩組 X 軸。如想沿著顯示數值的軸新增自訂標籤，這種做法就非常實用 (請參閱下例)。軸是從內部繪製而來，因此如果您有 x,x，第一個 x 代表最內層的副本，下一個 x 是指下一個向外副本，依此類推。

 

例子

說明 範例

這個範例顯示含有 X 軸、Y 軸、上軸 (t) 和右軸 (r) 的折線圖。

未指定任何標籤，因此圖表會預設為所有軸的 0 到 100 範圍。

請注意，根據預設，頂端和底部軸不會在標籤顯示勾號。

折線圖加上了標籤：左右兩側加上 0、25、40、60、80 和 100 個標籤，以及標籤：0、25、50、75 和 100，上下
chxt=x,y,r,t
您可以重複加入相同的值，為每個軸加入多組標籤。這個範例顯示兩組 x 和兩組 y 軸。這在僅使用預設軸標籤時並不實用，如此處所示。不過，您可以使用 chxl 參數，為每個軸的每個副本指定自訂標籤。

<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=7"=20&hl=zh-Hant" />

<img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=1"?hl=zh-Hant&hl=zh-Hant&hl=zh-Hant&hl=zh-TW|02030%30%27%

這個範例顯示包含 X 軸、Y 軸、上 T 軸和右側 r 軸的水平長條圖。

系統會省略軸標籤，因此 Chart API 會在 X 軸和 T 軸顯示 0 到 100 的範圍。

Y 軸和 r 軸的範圍取決於長條數量。在本範例中，共有五個長條，因此圖表 API 會顯示 0 到 4 的範圍。第一個標籤會置於第一個長條的中心，第二個標籤則位於第二個長條的底部，以此類推。

折線圖加上了標籤：左右兩側加上 0、25、40、60、80 和 100 個標籤，以及標籤：0、25、50、75 和 100，上下
chxt=x,y,r,t
只要在圖表類型後方指定 :nda，即可隱藏折線圖中的預設軸。 含有隱藏軸的折線圖
cht=lc:nda

返回頁首

軸範圍 chxr

您可以使用 chxr 參數，指定每個軸分別顯示的值範圍。請注意，這項操作「不會」 變更圖表元素的縮放，只會變更軸標籤的縮放。如要讓軸數字描述實際資料值，請分別將 <start_val> 和 <end_val> 分別設為資料格式範圍中下限和上限的值。詳情請參閱 Axis 資源調度相關說明。

如要指定軸範圍，請使用 chxt 參數顯示軸。

如要指定自訂軸值，請使用 chxl 參數。

語法

請使用直立線字元 ( |) 分隔多個軸標籤範圍。

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>
<axis_index>
要套用標籤的軸。這是從 chxt 指定的軸陣列內，從零開始的索引。舉例來說，R 軸在 chxt=x,r,y 中的是 1。
<start_val>
數字，定義這個軸的最小值。
<end_val>
數字，定義這個軸的最大值。
<opt_step>
[選用] 軸上刻點之間的計數步數。此步驟沒有預設的步驟值，系統會嘗試顯示一組適當的間距。

 

例子

說明 範例

這個範例顯示左右 Y 軸 (y 和 r) 和 1 軸 (x)。

每個軸都有定義的範圍。由於未指定任何標籤或位置，因此值會從指定範圍內取得，且會在該範圍內平均間距。在折線圖表中，各個值會沿著 X 軸平均分配。

r 軸 (索引 2) 的軸方向會反轉 (索引 2)，因為第一個值 (1000) 大於最後一個值 (0)。


chxt=x,y,r
chxr=
  0,0,500|
  1,0,200|
  2,1000,0

在本例中，X 軸指定的值。

軸標籤會沿著軸平均間隔。<opt_step> 參數的值為五 (5)。

長條圖，X 軸為 200、300 和 400 chxt=x
chxr=0,10,50,5

返回頁首

自訂軸標籤chxl

您可以使用 chxl 參數，在任何軸上指定自訂字串軸標籤。您可以視需要指定多個標籤，數量不限。如果您顯示軸 (使用 chxt 參數)，且未指定自訂標籤，系統會套用標準的數值標籤。如要指定自訂數字範圍，請改用 chxr 參數。

如要設定標籤在軸上的特定位置，請使用 chxp 參數。

語法

為每個要加上標籤的軸指定一組參數。請使用直立線字元 (|) 分隔多組標籤。

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>
<axis_index>
要套用標籤的軸。這是 chxt 參數陣列的索引。舉例來說，如果您有 chxt=x,x,y,y，那麼索引 0 會是第一個 x 軸，1 是第二個 X 軸。
<label_1>| ... |<label_n>
要沿著這個軸放置的一或多個標籤。這些可以是字串或數字值；字串不一定要在引號中。label_1 會顯示在軸上的最低位置，而 label_n 會以最高位置顯示。其他標籤會在每個標籤之間平均間距。以 + 符號表示空格。您無法在標籤中指定換行符號。請使用直立線字元分隔標籤。注意： 請勿在 chxl 參數的最後一個標籤後方放置直立線。

 

例子

說明 範例

這張圖表顯示如何在兩個軸上新增自訂標籤。請注意這些值的間距方式，以及最後一個 chxl 值不以直線結尾的結尾。

 折線圖左側是 0 和 100、右側是 A、B 和 C、X 軸是 1 月、7 月、1 月、7 月和 1 月，下方則是 2005、2006 和 2007
chxt=x,y
chxl=
0:|Jan|Feb|March|April|May|
1:|Min|Mid|Max

這個範例包含左右 Y 軸 (y 和 r) 的軸標籤，同時也包含 X 軸 (x) 的兩組值。您可以使用 chxs 在 Y 軸上加上刻點標記。

折線圖左側是 0 和 100、右側是 A、B 和 C、X 軸是 1 月、7 月、1 月、7 月和 1 月，下方則是 2005、2006 和 2007
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
1:|0|50|100|
2:|A|B|C|
3:|2005|2006|2007

這個範例包含左右 Y 軸的軸標籤 (y 和 r)，還有 X 軸 (x) 的兩組值。請注意，較低 x 軸組合的空白標籤，用來在值之間進行間隔。

這個範例使用左側 Y 軸上的軸標籤預設值。

長條圖左側為 0 和 100，右側是 A、B 和 C，X 軸是 1 月、7 月、1 月、7 月和 Jan，下方則是 2005、2006 和 2007
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
2:|A|B|C|
3:|2005||2006||2007

如果您想加入一般標籤來描述整個軸 (例如為某軸「費用」和「學生」加上標籤)，請使用 chxt 屬性在兩邊新增額外的軸，然後使用 chxl 兩邊新增一個自訂標籤，並使用 chxp 在軸中間放置一個自訂標籤。
chxt=x,x,y,y
chxl=1:|Martinis|3:|Score
chxp=1,50|3,50

返回頁首

軸標籤位置 chxp

您可以使用 chxl 指定的預設標籤或自訂標籤，指定要顯示的軸標籤。如果不使用這個參數指定確切位置，標籤會沿著軸平均間隔且採用預設步驟值。如未指定 chxl，勾號標籤就會為預設值 (通常是資料值或長條圖中的長條)。

語法

請使用直立線字元 (|) 分隔多個位置集。

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>
<axis_index>
您要指定位置的軸。這是 chxt 參數陣列的索引。舉例來說，如果您有 chxt=x,x,y,y，則索引 0 是第一個 x 軸，1 是第二個 x 軸，以此類推。
<label_1_position>,...,<label_n_position>
標籤沿著軸的位置。這是以半形逗號分隔的數值清單，其中每個值會設定 chxl 陣列中對應標籤的位置：第一個項目會套用至第一個標籤，依此類推。位置是該軸的範圍中的值。請注意，除非您已使用 chxr 指定自訂範圍，否則這個值一律為 0 至 100。依據為該軸的標籤數量，您必須以標籤數量為準。

 

例子

說明 範例

這個範例包含圖表上特定位置的 r 軸標籤。標籤文字是使用 chxl 參數指定。

指定位置為 0 的標籤會放在 Y 軸或 r 軸的底部，或是 X 軸或 t 軸左側。

指定位置為 100 的標籤會放在 Y 軸或 r 軸的頂端，或是 X 軸或 t 軸右側。

Line chart with min, average, and max on the right, 20, 40, 60, 80, and 100 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y,r
chxl=2:|min|average|max
chxp=2,10,35,75

這個範例說明顯示預設標籤值，但只會在指定位置顯示。

chxp=1,10,35,75 - Y 軸應該只顯示三個標籤：10、35 和 75。未指定自訂標籤文字，因此會顯示這些軸值。請注意，使用 chxp 時，標籤不必平均間隔。如果沒有在此指定 chxp，y 軸的預設標籤值距離將是每 20 個單位，如第二個圖表所示。

 Line chart with 10, 35, and 75 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y
chxp=1,10,35,75
顯示預設軸位置的折線圖。
chxt=x,y
未指定 chxp

返回頁首

軸標籤樣式chxs

您可以為軸標籤 (自訂標籤和預設標籤值) 指定字型大小、顏色和對齊方式。同一軸上的所有標籤格式皆相同。如果軸有多個副本，您可以用不同格式分別設定副本。您也可以指定標籤字串的格式，例如顯示貨幣符號或結尾的零。

根據預設，頂端和底部軸不會依值顯示勾號，左側和右側軸則顯示勾號。

語法

多個軸的值應以直立線字元 (|) 分隔。

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
<axis_indexaxis_index>
要套用此項目的軸。這是匯入 chxt 參數，從零開始的索引。
<opt_format_string>
[選用] 這是選用格式字串，如果使用的話，該字串緊接在軸索引編號後面，且中間沒有半形逗號。開頭會以常值字母 N 開頭，後面接有下列值 (選用)： 格式化字串語法如下：
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
以下是每個元素的含義：
  • <preceding_text> - 每個值前面的常值。
  • *...*：以常值星號括住的選用區塊，您可以在其中指定數字的格式詳細資料。系統支援下列值，你不一定要使用這些值：
    • <number_type> - 數字格式的數字格式。選擇下列其中一種交通方式：
      • f - [預設] 浮點格式。建議您使用 <decimal_places> 值來指定精確度。
      • p - 百分比格式。系統會自動附加 % 符號。注意：使用這種格式時，資料值會從 0.0 - 1.0 對應至 0 - 100% (例如，0.43 會顯示為 43%)。
      • e - 科學記號格式。
      • c<CUR>：以指定幣別設定數字格式，並使用適當的貨幣標記。將 <CUR> 替換為三個字母的貨幣代碼。例如：cEUR 代表歐元。您可以在 ISO 網站找到代碼清單，但系統僅支援部分符號。
    • <decimal_places> - 一個整數，用來指定要顯示的小數位數。這個值會四捨五入 (不會截斷) 至這個長度。預設值為 2。
    • z - 顯示結尾的零。預設值為 no。
    • s - 顯示群組分隔符。預設值為 no。
    • x 或 y：依指定顯示 x 或 y 座標的資料。x 資料的意義因圖表類型而異：您可以用圖表進行實驗，判斷資料的意義。預設值為 'y'。
  • <following_text>：每個值接續的常值文字。
<opt_label_color>
要套用至軸文字 (而非軸線) 的顏色，以 RRGGBB 十六進位格式。使用 opt_axis_color 可個別指定軸線顏色。預設值為灰色。
<opt_font_size>
[選用] 可指定字型大小 (以像素為單位)。這是選用參數。
<opt_alignment>
[選用] 標籤對齊設定。針對頂端或底部軸，這項資訊說明瞭標籤與上方或下方的刻點標記對齊的方式。如果是左側或右側軸，則說明在定界框內對齊時 (輕觸軸) 的方式。指定下列其中一個數字：
  • -1 - 頂端或底部：標籤在刻點的右側；向左或向右：標籤在所屬區域靠左對齊。R 軸標籤的預設值。
  • 0 - 頂端或底部：標籤位於刻點中央；向左或向右：標籤在其區域置中。X 軸和 T 軸標籤的預設設定。
  • 1 - 頂端或底部：標籤在刻點的左側；向左或向右：標籤在所屬區域靠右對齊。Y 軸標籤的預設值。
<opt_axis_or_tick>
[選用；Google-o-meter 不支援] 是否顯示這個軸的刻點標記和/或軸線。虛線標記和軸線僅適用於最內側的軸 (例如，兩個 X 軸的外側不支援)。請使用下列其中一個值：
  • l (小寫「L」) - 僅繪製軸線。
  • t - 只畫出勾號。勾號是指軸標籤旁的小線條。
  • lt：[預設] 繪製所有標籤的軸線和刻點標記。
  • _ - (底線) 不繪製軸線和刻點符號。如要隱藏軸線，請使用這個值。
<tick_color>
[optional; not 支援 in Google-o-meter] 刻點標記顏色，使用 RRGGBB 十六進位格式。預設值為灰色。
<opt_axis_color>
[選用] 這個軸線的顏色，使用 RRGGBB 十六進位格式。預設值為灰色。

 

例子

說明 範例

第二個 X 軸 (1 月、2 月、3 月) 已指定字型大小和顏色。

折線圖左側是最小值、平均值和最大值、右側的 0、1、2、3 和 4，X 軸代表 0 至 100，下方則是 1 月、2 月和 3 月，以藍色標示

chxt=x,y,r,x
chxr=2,0,4
chxl=3:|Jan|Feb|Mar|
     1:|min|average|max
chxp=1,10,35,75
chxs=3,0000DD,13,0,t

字型大小、顏色和對齊方式是在右側 Y 軸上。繪製是沒有軸線的勾號。

折線圖以 0 到 100 軸表示，X 軸依序為 0 到 100、1 軸、2 月份、3 分、Y 軸和 0 至 4 符號，Y 軸表示最小值、平均值和最大值的紅色刻點。

chxt=x,y,r,x
chxl=3:|Jan|Feb|Mar|
     2:|min|average|max
chxp=2,10,35,95
chxs=2,0000DD,13,-1,t,FF0000

這張圖表包含三個資料集，並顯示三組軸標籤 (每個序列一個)。每一組標籤都會使用自訂格式設定字串格式化，如下所示：

  • 0N*e,000000|
    • 0 代表第一個資料序列
    • N 表示格式化字串
    • * 表示格式指定碼的開頭
    • e 表示科學記號
    • * 表示格式指定碼的結尾
    • 000000 表示黑色文字。
  • 1N*cUSD*Mil,FF0000|
    • 1 表示第二個系列
    • N 表示格式化字串
    • * 表示格式指定碼的開頭
    • c 表示貨幣標記
    • USD 會將美元指定為要使用的貨幣標記
    • * 表示格式指定碼的結尾
    • Mil 是後面的字串
    • FF0000 表示紅色文字。
  • 2N*sz2*,0000FF
    • 2 代表第三系列
    • N 表示格式設定字串
    • * 表示格式指定碼的開頭
    • s 表示顯示分組指定碼 (在美式英文語言代碼中，每三個零為一個半形逗號)
    • z2 表示結尾是兩個零
    • 0000FF 表示藍色文字。

軸標籤範圍是使用 chxr 參數 (axis_index、start、end、step) 來設定。如未設定，預設值為 0 至 100。
chd=s:
  984sttvuvkQIBLKNCAIi,
  DEJPgq0uov17zwopQODS,
  AFLPTXaflptx159gsDrn
chxr=
  0,0,1000000,250000|
  1,0,60|
  2,0,5000
chxs=
  0N*e,000000|
  1N*cUSD*Mil,FF0000|
  2N*sz2*,0000FF

返回頁首

軸線標記樣式chxtc

您可以為特定軸指定長刻度記號。通常用於延長圖表長度的勾號。使用 chxs 參數即可變更勾號顏色。

多個軸的值應以直立線字元 (|) 分隔。系列中的值應以半形逗號分隔。

語法

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>
<axis_indexaxis_index>
要套用此項目的軸。這是匯入 chxt 參數，從零開始的索引。使用長條符號分隔不同軸的值。
<tick_length_1>,...,<tick_length_n>
該軸上的刻度標記長度，以像素為單位。如果指定單一值，這個值就會套用至所有值；如果指定了多個值，軸刻點標記會在該軸的值清單上循環播放。正值會在圖表區域外繪製，並由圖表邊框裁剪。正值的最大值為 25。負值會繪製在圖表區域內，並由圖表區域邊框裁剪。

 

例子

說明 範例

使用 chxtc 建立長紅色勾號的範例。此處的勾號標記長度超過圖表區域寬度，但經過裁剪以符合圖表大小。

  • chxt=x,y,r,x - 顯示左軸、右軸和底部軸。
  • chxl=2:|min|average|max|3:|Jan|Feb|Mar - 指派給「r」(右側) 和外部 X 軸的標籤文字。
  • chxp=2,10,35,95 - 三個標籤的自訂標籤位置，沿著 r 軸 (index=2) 的位置。
  • chxs=2,0000dd,13,-1,t,FF0000 - r 軸的標籤樣式：文字顏色、文字大小、靠左對齊及紅色勾號。
  • chxtc=1,10|2,-180 - y 和 r 軸的軸尺長度。第一個值指定軸外的 10 個像素長刻點。第二個值在軸上指定 180 像素的長刻度；負數表示刻點位於軸內，而刻點則經裁剪，以符合圖表內的大小。

折線圖以 0 到 100 軸呈現，X 軸依序為 0 到 100、1 軸、2 月份、3 分、Y 軸和 0 至 4 符號，Y 軸代表最小、平均和最大紅色刻度。

chxt=x,y,r,x
chxl=
  2:|min|average|max|
  3:|Jan|Feb|Mar
chxp=2,10,35,95
chxs=
  2,0000dd,13,-1,t,FF0000
chxtc=1,10|2,-180
這張圖表顯示的是交替刻度長度。chxtc 會指定 Y 軸 (5 和 15) 的兩個刻點長度值，而圖表上繪製的刻度在兩個值之間會交替使用。
chxt=x,y
chxtc=
  1,5,15

返回頁首

背景填滿 chf [所有圖表]

您可以指定圖表資料區域和/或整個圖表背景的填滿顏色和樣式。填滿類型包括單色、條紋填滿和漸層。您可以為不同區域指定不同的填滿 (例如整個圖表區域，或僅限資料區域)。圖表區域填滿會覆寫背景填滿效果。所有填滿效果都是使用 chf 參數指定，而且您可以在同一個圖表中混用不同的填滿類型 (單色、條紋、漸層)。以直線字元 ( | ) 分隔值。圖表區域會填滿圖表背景填滿效果。

填滿填滿chf [所有圖表]

您可以為背景和/或圖表區域指定實心填滿，或為整個圖表指派透明度值。您可以使用直立線字元 (|) 指定多個填色 (地圖：僅限背景)。

語法

chf=<fill_type>,s,<color>|...
<填入類型fill_type>
圖表中填滿的部分。你可以指定下列其中一個值：
  • bg - 背景填滿
  • c - 圖表區域填滿。不支援地圖圖表。
  • a - 將整個圖表 (包括背景) 設為透明。系統會忽略 <color> 的前六位數，且只會將最後兩位數 (透明度值) 套用至整個圖表和所有填滿效果。
  • b<index> - 長條純填滿 (僅限長條圖)。將 <index> 替換為長條的序列索引，以填入單色。效果與在長條圖中指定 chco 類似。如需範例，請參閱長條圖圖表系列顏色。
秒
代表實心或透明度填滿。
<color>
填滿顏色，採用 RRGGBB 十六進位格式。如果是轉碼，系統會忽略前六位數，但仍必須加入。

 

例子

說明 範例

這個範例會以灰色 (EFEFEF) 填滿圖表背景。

填滿黑色區域填滿的紅線圖。

chf=bg,s,EFEFEF

這個範例會以淡灰色 (EFEFEF) 填滿圖表背景，並以黑色 (000000) 填滿圖表區域。

紅線圖，上面有黑色圖表區，背景為灰色。

chf=c,s,000000|
bg,s,EFEFEF
這個範例對整個圖表套用 50% 的透明度 (128 十六進位數字 80 或約 50%)。請注意，透過圖表顯示的表格儲存格背景。

以藍色標示點和 50% 透明度的散佈圖。

chf=a,s,00000080

返回頁首

漸層填滿chf [Line、Bar、Google-o-meter、Radar、Scatter、Venn]

您可以將一或多個漸層填滿效果套用至圖表區域或背景。漸層填滿效果會從一種顏色淡出。(圓餅圖、Google-公制圖表：僅限背景)。

每個漸層填滿會分別指定角度，以及錨定至指定位置的兩種以上顏色。不同錨點之間移動時，顏色各有不同。必須有至少兩種具有不同 <color_centerpoint> 值的顏色，才能淡入另一個顏色。每個其他漸層都由 <color>,<color_centerpoint> 配對指定。

語法

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>
<填入類型fill_type>
要填滿的圖表區域。下列其中一欄：
  • bg - 背景填滿
  • c - 圖表區域填滿。
  • b<index> - 長條漸層填滿 (僅限長條圖)。將 <index> 換成長條的序列索引，以填入漸層。如需範例，請參閱長條圖圖表系列顏色。
lg
指定漸層填滿。
<角度>
這個數字可指定從 0 (水平) 到 90 (垂直) 的漸層角度。
<color>
填滿顏色，以 RRGGBB 十六進位格式。
<color_centerpoint>
指定顏色的錨點。接近另一個錨點時，顏色就會從這個點開始淡出。這個值的範圍介於 0.0 (底部或左側) 到 1.0 (頂端或右側邊緣)，並傾斜至 <angle> 指定的角度。

 

例子

說明 範例

圖表區域具有水平線性漸層，並以零度 (0) 的角度指定。

顏色為桃紅色 (FFE7C6)，置中於左側 (位置 0.0)，藍色 (76A4FB)，右側則是置中 (位置：1.0)。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，由左至右分別為白色及藍色線性漸層

chf=
  c,lg,0,
  FFE7C6,0,(桃紅色)
  76A4FB,1 (藍色)

圖表區域採用對角線 (從左下到右下方) 線性漸層，指定的角度為四十五度 (45)。

桃紅色 (FFE7C6) 是第一個指定的顏色。圖表左下方是「純桃色」。

藍色 (6A4FB) 是指定的第二個顏色。圖表右上方純藍色。請注意，我們如何指定 0.75 的偏移值，以提供向右上角逐漸消失的藍色尖峰。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，從左下到右、白色到藍色的對角線漸層

chf=
  c,lg,45,
  FFE7C6,0, (桃紅色)
  76A4FB,0.75 (藍色)

圖表區域具有垂直 (由上至下) 線性漸層，其角度為九十度 (90)。

藍色 (76A4FB) 是指定的第一個顏色。圖表頂端純藍色。

桃紅色 (FFE7C6) 是指定的第二個顏色。圖表底部是純桃色。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，由下往上到藍色垂直的垂直漸層

chf=
  c,lg,90,
  FFE7C6,0, (桃紅色)
  76A4FB,0.5 (藍色)

返回頁首

 

條紋填滿chf [Line, Bar, Google-o-meter, Radar, Scatter, Venn]

您可以為圖表區域或整個圖表指定條紋背景填滿效果。(圓餅圖、Google-公制圖表：僅限背景。)

語法

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>
<填入類型fill_type>
要填滿的圖表區域。下列其中一欄：
  • bg - 背景填滿
  • c - 圖表區域填滿
  • b<index> - 條紋填滿 (僅限長條圖)。將 <index> 取代為要以條紋填滿的長條的序列索引。如需範例，請參閱長條圖系列顏色。
ls
指定線性條紋填滿效果。
<角度>
所有條紋的角度 (相對於 Y 軸)。使用 0 做為垂直條紋，使用 90 做為水平條紋。
<color>
此條紋的顏色，採用 RRGGBB 十六進位格式。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表，否則會進行替換。
<width>
此條紋的寬度，從 0 到 1，其中 1 是圖表的完整寬度。系統會重複新增線條，直到圖表填滿為止。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表，否則會進行替換。

 

例子

說明 範例
  • bg,ls,0 - 背景條紋填滿 y 軸 (與 Y 軸平行的零度角) 的條紋。線條會填滿圖表背景和繪圖區域。
  • CCCCCC,0.15 - 第一個條紋呈現深灰色，寬度為圖表寬度 15%。
  • FFFFFF,0.1 - 第二條條紋是白色，寬度為 10%，與圖表寬度相同。
 藍色折線圖，從左到右交錯呈灰色和白色條紋
chf=
  bg,ls,0,
  CCCCCC,0.15,
  FFFFFF,0.1
  • c,ls,90 - 圖表區域，Y 軸上有水平條紋，角度為九十度。線條會填滿圖表區域，但圖表背景省略。
  • 999999,0.25 - 第一條紋是深灰色，寬度為圖表寬度 25%。
  • CCCCCC,0.25 - 與第一條紋相同，但淺灰色。
  • FFFFFF,0.25 - 與第一條紋相同，但白色。
 由下到上、深灰色、淺灰色、白色和深灰色條紋的藍線圖
chf=
  c,ls,90,
  999999,0.25,
  CCCCCC,0.25,
  FFFFFF,0.25

返回頁首

換行 chm [Line, Radar]

您可以使用單色填滿資料行下方的區域。

您可以使用直立線字元 ( |) 結合行填入與任何其他 chm 參數，以分隔 chm 參數。

語法

chm=
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
    |...|
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
<b_or_B>
選擇要填滿圖表底部，還是只填滿下一行。
  • B - 從 <start_line_index> 填滿圖表底部。<end_line_index> 支援特殊語法，可讓您填入圖表片段。最簡單的方法是在圖表中加入想填滿的單一線條。
  • b - 填滿多線圖中的兩條線。起始行和結尾線會以 <start_line_index> 和 <end_line_index> 表示。
<color>
填滿顏色的 RRGGBB 格式十六進位數字。
<start_line_index>
填入開始的行索引。chd 中指定的第一個資料序列的索引為 0 (0)，第二個資料序列的索引為 1，依此類推。
<end_line_index>
  • 填入類型「b」- 要停止填滿的行。這一行必須低於目前行。
  • 填入類型 「B」- 下列其中一個選項：
    • any value - 系統會忽略這個參數中的所有單一數字，填入從指定線條到圖表底層的填滿效果
    • start:end：如要填滿圖表下方的垂直區塊，請指定 start:end，其中這些資料點索引會說明開始和停止填滿的位置。這兩個值皆為選用值，預設為 first_point:last_point。 (請參閱以下範例)。
<0>
預留項目 - 必須為零。

 

例子

說明 範例

如果是單一系列叢書，最簡單的方法就是使用 chm=B。 這會填滿線條下方的整個區域。

雷達圖只能使用這個填滿區域類型。chm=b 不適用於雷達圖。


chm=B,76A4FB,0,0,0

以下是其中有兩條折線和兩條填滿的圖表。填寫底線下方的區域和第一行上方必須用到特殊技術，接下來我們會說明。


chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0| (藍色)
b,FF0000,1,2,0| (紅色)

在多線圖中，如要從圖表頂端填滿第一行，您需包含的序列包含資料格式中最高資料值的兩個複本。因此，例如用於擴充編碼的「....」，「100,100」代表基本文字格式，依此類推。從本系列影片到第一行。

如要填滿圖表的最後一行，請納入一系列的序列，其中包含資料格式最低資料值的兩個複本。例如，擴充編碼的 AAAA、基本文字格式 0,0 等等。

線條本身會以黑色繪製，並使用 chco 繪製。

 圖表上有三條線；圖中由下到第一條以綠色顯示，紅色從第一線到第二線，深藍色，第三條線到第三線，以及淡藍色
chd=e:
  ...., (最高值)
  cefhjkqwrlgYcfgc,
  QSSVXXdkfZUMRTUQ,
  HJJMOOUbVPKDHKLH,
  AAAA (零值)
chm=
  b,76A4FB,0,1,0| (淺藍色)
  b,224499,1,2,0| (藍色)
  b,FF0000,2,3,0| (紅色)
  b,80C65A,3,4,0 (綠色)
chco=000000

以下是垂直填滿區塊的折線圖。方法是為 <end_line_index> 指定 start:end 組合，行填入類型「B」。

  • B,76A4FB,0,0:3,0 - 第 0 行下方的藍色垂直填滿，由資料點 0 到 3 繫結。
  • B,990000,0,7:10,0 - 第 0 行下方的紅色垂直填滿，以資料點 7 至 10 的限制。
  • B,DEDC06,0,12:,0 - 從資料點 12 到系列結尾，第 0 行下方的黃色垂直填滿。
chm=
  B,76A4FB,0,0:3,0|
  B,990000,0,7:10,0|
  B,DEDC06,0,12:,0

以下範例說明如何在雷達圖中使用線條填滿。

 雷達圖
chm=
  B,FF000080,0,1.0,5.0|
  B,FF990080,1,1.0,5.0

返回頁首

格線chg [Line、Bar、Radar、Scatter]

您可以使用 chg 參數指定圖表上的實線或虛線格線。

但你無法指定線條的粗細或顏色。想瞭解更多在圖表上繪製線條的方法，請參閱形狀標記 (chm 類型 h、H、v 或 V)、範圍標記 (chm) 和軸刻點標記 (chxtc)。

語法

chg=
  <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
<x_axis_step_size>、<y_axis_step_size>
用於計算圖表要顯示多少 x 或 Y 格線線。100 / step_size = 圖表中的格線數。因此，20,25 代表 5 個垂直格線和 4 條水平格線。
<opt_dash_length>、 <opt_space_length>
[選用] 用於定義虛線格線。第一個參數是每一行虛線的長度 (以像素為單位)。 第二個參數是虛線之間的間距 (以像素為單位)。將 <opt_space_length> 指定為 0，表示實線。預設值為 4,1。
<opt_x_offset>,<opt_y_offset>
[選用] 依圖表比例縮放的單位數量，分別用來偏移 x 和 y 格線線。可以是正值或負值。如果您要指定這個值，也必須一併指定所有先前的值。預設值為 0,0。

 

例子

說明 範例

這些範例只會使用 <x_axis_step_size> 和 <y_axis_step_size> 參數。根據預設，Chart API 會顯示虛線格線。

 折線圖中有 5 個垂直和兩條水平淡灰色虛線格線
chg=20,50
折線圖中有 5 個垂直和兩條水平淡灰色虛線格線
chg=20,50

此範例使用較大的空格來顯示較淺的格線 (1,5)。

 折線圖中有 5 種垂直和兩條水平色調，淺灰色與虛線格線
chg=20,50,1,5

如要顯示實線格線，請將 <opt_space_length> 參數指定為零 (0)。

此外，這張圖表的 X 軸偏移值是 10。

 折線圖中有 5 個垂直和兩條水平淡灰色，實心格線
chg=20,50,1,0,10

此圖表顯示 X 軸偏移值 10，y 軸偏移為 20。

 折線圖中有 5 個垂直和兩條水平淡灰色，實心格線
chg=20,50,3,3,10,20

返回頁首

動態圖示標記 chem [Bar、Line、Radar、Scatter]

建立圖表，並將一或多個動態圖示指定為化學值。chem 的語法如下。紫色以半形分號分隔的所有項目皆為選用，在網址中即可完全省略這些項目。如要加入多個標記，可以加入多個以 | 字元分隔的語法字串。如要進一步瞭解動態圖示，請參閱動態圖示頁面。

您也可以將圖表嵌入其他圖表，做為動態圖示。請參閱下方的「內嵌圖表」子章節。

chem=
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
   |...|
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
s=<icon_string_constant>
動態圖示的字串標記常數，來自動態圖示頁面。此常數與獨立圖示的 chst 參數「幾乎」相同。但若獨立圖示字串的開頭是「d_」，您應該移除這個前置字串，才能取得對等的動態圖示標記。範例：獨立圖示：d_bubble_icon_text_small；對等的動態圖示標記：bubble_icon_text_small。
d=<marker_data_stringmarker_data_string>
這個特定標記類型需要的資料。這會保留用於在 chld 參數中用於對等獨立圖示的字串，不過 ，所有 | 分隔符號都應以半形逗號取代 (請記得使用半形逗號取代多行文字的直立線標記！)。請注意，在資料字串中，您也必須使用 @ 符號逸出下列字元：直立線 ( | )、 at ( @ )、等於 ( = )、半形逗號 ( , )、分號 ( ; )。 範例：hello@,+world、5@@10+cents+each。
ds=<which_series>
[選用] 這個標記所屬的資料序列索引，從零開始。預設值為 0。
dp=<which_points>
[選用] 指定用來繪製標記的資料點。預設值為 0 (系列的第一個點)。請使用下列其中一種格式：
  • n.d - 要繪製標記的資料點，其中「n.d」n.d是序列中從零開始的索引。如果指定非整數值，分數則會指出計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • range,<start>,<end>,<step> - 在從 start 到 end (含) 之間的每個 step 資料點上繪製標記。起始和結束是索引值，可以是浮點數，用來表示中繼值。所有值皆為選用值，預設值為：start=0、end=last item、step=1。如果略過值，仍須加入任何中繼逗號，但不必加入空白的結尾半形逗號。例如：dp=range,0,4 會在元素 0 到 4 上繪製標記；dp=range,5,10,2 會在元素 5、7 和 9 上繪製標記；dp=range,2 會在第三個點和較晚的點上繪製點；dp=range,3,,1.5 會在從四個項目到最後一個項目之間的每 1.5 個資料點上繪製標記。
  • all - 為每個元素繪製標記。這相當於 range,0,end_index。範例：dp=all
  • every,n - 在每個第 n 個標記上繪製標記。範例：dp=every,2 會在項目 0、2 和 4 上繪製標記。
py=<z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線圖和長條) 正低於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
po=<x,y>
[選用] 圖表上繪製標記時的絕對位置。x 和 y 是兩個浮點數，其中 0.0,0.0 是左下角，1.0,1.0 代表右上角。
=<x_offset,y_offset>
[選用] 代表圖示與正常位置偏移的像素數量。x_offset 和 y_offset 為正整數或負整數。請務必在嵌入的動態圖示中指定這個值，因為標記會沿著該點的垂直和水平置中，也就是說，該點可能不會與資料標記對齊。直立圖釘的理想位移為 of=0,22；傾斜圖釘的良好位移是 of=-12,20 或 of=12,20，視斜面方向而定，但您可能必須進行實驗。預設值為 0,0。

 

例子

說明 範例
在以下示例中，同樣的動態圖示是以獨立圖片的形式建立，並當做折線圖中的標記使用。

圖表 1：https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499&
chd=t:75,74,66,30,10,5,3,1&chls=1|1&
chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2

圖表 2：https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000

含有動態圖示標記的折線圖。
chem=
  y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0

動態圖示標記與獨立圖片相同。


chst=
  d_bubble_icon_text_small
chld=
  ski|bb|Wheeee!|FFFFFF|000000

請注意，動態圖示標記的水平和垂直置中。因此，如果您使用含有尾數的動態圖示，尾部並不會位於圖表點上，因此標記中心為。第一張圖表將標記置於資料點 3 的中心，該資料點實際上將尾部稍微放在線條上的標記右側。

第二個圖表使用 of 值，將標記的尾部移至所需資料點上方。傾斜圖釘的良好位移為 -12,20。
chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1

chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1;
  of=-12,0

如要加入多個動態圖示，請重複使用 | 字元分隔的語法字串。

這個範例顯示一個範圍以及兩個個別標記。

請注意垂直圖釘與 0,22 之間的位移，傾斜圖釘的偏移值則為 12,20，讓圖釘與所描述的序列對齊。
chem=
  y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|
  y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|
  y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
這說明瞭多行文字標記。新增文字後，標記必須偏移，因為對話框會依照文字調整大小，進而在圖表上重新置中。請注意，在 d 資料字串中，文字中的換行符號會以半形逗號表示。
chem=y;
  s=bubble_texts_big;
  d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;
  ds=0;
  dp=13;
  of=-120,2

內嵌圖表

您可以使用動態圖示語法，將圖表嵌入其他圖表。

嵌入圖表標記有兩種樣式：嵌入泡泡中的圖表，以及不含泡泡的嵌入式圖表。以下是這兩種網址的範例：

無泡泡圖
含有泡泡的圖表
不含泡泡的圖表

以下是 s=<icon_string_constant>;d=<marker_data_string> 參數的具體細節，適用於非對話框和泡泡內嵌圖表 (以上說明的參數不會再次說明)：

語法

Non-bubble:
  chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>

Bubble:
  chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
alignment_string
[僅限非對話框] 無泡泡嵌入圖表的哪個部分會固定在資料點。請選擇下圖中的其中一個雙字母字串常數：校正字串
chart_data
嵌入圖表的資料。以上就是要嵌入圖表網址 https://chart.googleapis.com/chart? 後方的所有內容。請使用下方的工具，或是遵循工具下方的規則。
frame_type
[Bubble only] 其中一個動態圖示框架樣式常數。
邊框間距
[僅限對話框] 對話框中的邊框間距 (以像素為單位)。
frame_color
[僅限對話框] 影格顏色，以六位數 HTML 顏色字串表示，不含 # 標記。範例：FF00FF。
fill_color
[僅限對話框] 對話框內填充顏色的六位數 HTML 顏色字串，不含 # 標記。範例：FF00FF。

已嵌入圖表資料

請使用以下轉換工具來產生圖表字串，或按照工具隨後提供的規則，手動產生圖表字串。

手動轉換規則

1. 首先，依照顯示順序，將參數和值組合中的所有下列字元替換為下列值：

取代 有了
%7C 或 %7c
|
@
@@
%
%25
,
@,
|
@|
;
@;
&
%26
=
%3D

2. 然後將 parameter1=value1&parameter2=value2... 組合中的所有 & 和 = 值替換為半形逗號。

返回頁首

形狀標記 chm [長條圖、線條、雷達、散佈圖]

您可以為圖表上的所有或個別資料點指定圖形標記。如果多個標記位於同一個點，則系統會依照標記在 chm 參數中顯示的順序繪製這些標記。您也可以針對資料點建立文字標記，詳情請參閱資料點標記。

您可以使用直立線字元 ( |) 合併形狀標記與任何其他 chm 參數，藉此分隔 chm 參數。

語法

請為應標記的各個系列指定下列一組參數。如要標記多個系列，請建立其他參數組合，並以直立線字元分隔。您不必標記所有系列叢書。如果沒有為資料序列指派標記，該系列將不會取得任何標記。

形狀標記在散佈圖表中的行為略有不同。詳情請參閱相關說明文件。

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
@
[選用] 如果您在標記類型前面加上選用的 @ 字元，則 <opt_ which_points> 應使用 x:y 格式。
<marker_type>
要使用的標記類型。指定下列其中一種類型：
  • a - 箭頭
  • c - 交叉
  • C - 矩形。如果有矩形標記，則必須有至少兩個資料序列，其中序列 0 指定底部邊緣，序列 1 則指定頂部邊緣。<size> 會指定矩形的寬度 (以像素為單位)。
  • d - 鑽石
  • E - 錯誤列標記 ( ) 建立這個標記需要兩個資料序列，一個值代表底部，而第二個序列中代表的對應點。此外，還會公開擴充的 <size> 語法：line_thickness[:top_and_bottom_width]，其中 top_and_bottom_width 為選用項目。請參考下列範例。
  • h - 以指定高度在圖表中跨越的水平線。 (<opt_which_points> 參數的唯一有效格式為 opt_which_points)。
  • H - 水平線穿過指定的資料標記。這支援擴充的 <size> 語法，可讓您指定確切的行長度：line_thickness [:length]，其中 :length 為選用設定，預設為整個圖表區域寬度。
  • o - 社交圈
  • s - 正方形
  • v - 從 X 軸到資料點的垂直線
  • V - 可調整長度的垂直線。這支援擴充的 <size> 值語法，可讓您指定確切的行長度：line_thickness[:length]，其中 :length 為選用設定，預設為整個圖表區域高度。標記會設定在資料點中心。
  • x - 一個 X
<color>
這個序列的標記顏色，採用 RRGGBB 十六進位格式。
<series_index>
要繪製標記的資料序列的從零開始索引。如果 h 標記和標記是以 x/y 位置指定位置 (開頭為 @ 字元)，系統會忽略這項設定。您可以使用隱藏的資料序列做為標記的來源，詳情請參閱複合圖表。分組的垂直長條圖支援特殊擴充語法，以便將標記與特定長條對齊。
<opt_which_points>
[選用] 要在哪些點上繪製標記。預設值為所有標記。請使用下列其中一個值：
  • n.d：標記的繪製位置。意義視標記類型而定：
    • h 以外的所有類型：要繪製標記的資料點，其中「n.d」是序列中以零為基礎的索引。如果指定非整數值，分數則代表計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
    • h - 介於 0.0 到 1.0 之間的數字，其中 0.0 代表圖表底部，而 1.0 位於圖表頂端。
  • -1 - 在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有資料點上進行繪製。
  • -n - 在每個「n」n個資料點上繪製標記。浮點值；如果 n 小於 1，圖表會為您計算其他中介點。例如，-0.5 將放置的標記數量為資料點的兩倍。
  • start:end:n - 在範圍中的每「n」n個資料點上繪製標記，從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目，因此 3:1 會從第四個元素到最後一個元素，步驟 1 中完全省略這個參數，則會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值，從最後一個值反向計算。如果 start 和 end 均為負值，請確認這些項目都已列為遞增的值 (例如 -6:-1:1)。 如果 n 步值小於 1，它將透過內插指定資料值來計算其他資料點。預設值為 first:last:1
  • x:y：在圖表上的特定 x/y 點繪製標記。這個點不一定要位於線路上。如要在標記類型前加上 @ 字元，請使用這個選項。將座標指定為浮點值，其中 0:0 是圖表左下角，1:1 是圖表右上角。舉例來說，如要將 15 像素的紅色菱形加入圖表中央，請使用 @d,FF0000,0,0.5:0.5,15。
<size>
標記的大小，以像素為單位。這個參數最多採用單一數字值；V、H 和 S 標記支援 <size>[:width] 語法，且選用的第二部分可指定行或標記長度。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線圖和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
<opt_offset>
[選用] 可讓您指定與指定位置之間的水平和垂直偏移值。以下是使用 : 分隔符號的語法：reserved:<horizontal_offset>:<vertical_offset>。如果有指定，即可在 <opt_z_order> 的 chm 參數字串中加入空白的 , 值。範例：o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
  • reserve (保留) - 留空。
  • <horizontal_offset>：指定水平偏移的正數或負數，以像素為單位。選用；如未使用，請留空。
  • <vertical_offset>：指定垂直偏移的正數或負數，以像素為單位。選用；如未使用，請留空。

 

例子

說明 範例

以下是幾種形狀和線條標記的範例。

  • a,990066,0,0.0,9.0 - 紫色箭頭、第一個序列、第一個點，尺寸 9。
  • c,FF0000,0,1.0,20.0 - 紅色十字、第一個序列、第二個點，尺寸 9。
  • d,80C65A,0,2,20.0 - 綠色菱形，第一個序列，第三個點，尺寸 9。
  • H,000000,0,3,1:40 - 黑色水平線、第一個序列、資料點 3、一個像素寬度、40 個像素長。
  • o,FF9900,0,4.0,12.0 - 橘色圓圈，第一個序列，第五點，尺寸為 12。
  • s,3399CC,0,5.0,11.0 - 藍色正方形，第一個序列，第六點，尺寸 11。
  • v,BBCCED,0,6.0,1.0 - 向上垂直線，向上線，第一個序列到第七點，寬度為一個像素。
  • V,3399CC,0,7.0,1.0 - 圖表頂端垂直線，第一個序列、第一個序列、八點、一個像素寬度。
  • x,FFCC33,0,8.0,20.0 - 黃色 'X'，第一個系列，第九點，大小為 20。
  • H,FFFF00,0,9,2 - 資料點 9 處的圖表寬度水平線。
  • h,FF0000,0,0.5,1 - 指定高度的紅色水平線、第一個序列、在圖表上半部、寬度為一個像素的寬度。
 含有標記的折線圖
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

以下舉例說明一個資料序列使用菱形的方法，以及其他資料序列的圓形。

如果多個標記位於相同點，則系統會依照標記在 chm 參數中顯示的順序繪製這些標記。在這裡，圓形是第一個使用 chm 指定的標記，因此會先繪製。指定並繪製菱形的秒數，使其繪製在圓形頂端。

 折線圖，另一條線各有 15 個像素圓圈，另一線則有 10 個像素菱形。兩條線同時有一個菱形上繪製了菱形
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

折線圖是每秒一個資料點 (-2 代表所有其他點)。

 每第二個點含有標記的折線圖
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
以下是折線圖，標記數量是資料點的兩倍 (-0.5 代表每半點)。 每第二個點含有標記的折線圖
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
這個範例說明如何使用 h 和 v 標記，建立自訂顏色和粗細的格線。Z 軸值 (最後一個值) 會設為 -1，這樣就會在資料行下方繪製格線。
每第二個點含有標記的折線圖
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

這張圖表會在折線圖中加入垂直填滿線：

  • v：與圖表的垂直線
  • FF0000 - 紅線
  • 0 - 序列索引
  • : :.5 - 範圍指定碼：從頭到尾，每 0.5 個點。
  • 2 - 厚度 2 像素。
 每第二個點含有標記的折線圖
chm=
  v,FF0000,0,::.5,2
這個範例會使用確切座標，在圖表中加入箭頭和文字標記。第一個 D 標記是長條下方的追蹤記錄行，第二個標記是箭頭，第三個標記是箭頭文字。
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
固定為特定資料點的水平線 (H) 很適合用來顯示相對值，或強調圖表中資料值的高度。
chm=H,FF0000,0,18,1

這張圖表展示了可在 <size> 參數中指定線條粗細和長度的標記。

  • E,000000,0,6,1:20 - 黑色錯誤列，內含 1 個像素寬行，頂端和底部長條為 20 像素。底部錨定至序列 0 點 8，頂部固定為序列 1 點 8。
  • H,990066,1,2,5:50 - 紫色水平線 5 像素，長為五十個像素，中心點為資料點 2。
  • V,3399CC,0,8,3:50- 藍色垂直線 3 像素寬，50 個像素，置中於資料點 8。
 title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,9900CV6,1,2,506"
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

返回頁首

文字和資料值標記 chm [Bar、Line、Radar、Scatter]

您可以用自訂文字或當時的格式化版本資料，為圖表上的特定點加上標籤。

您可以使用直立線字元 ( |) 合併任何 chm 標記，藉此分隔 chm 參數組合。

字串值的注意事項：標籤字串只能使用安全網址字元。為了安全起見，如果字串包含非字元集 0-9a-zA-Z 中的字元，您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。

語法

請為應標記的各個系列指定下列一組參數。如要標記多個系列，請建立其他參數組合，並以直立線字元分隔。您不必標記所有系列叢書。如果沒有為資料序列指派標記，該系列將不會收到任何標記。

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
<marker_type>
要使用的標記類型。可選用的類型如下：
  • f<text> - 包含文字的旗標。請指定「f」字元，後面接著自訂網址編碼的文字。如要在文字標記中逸出半形逗號，請在半形逗號前方加上 \ 符號。範例：fHello\,+World!
  • t<text> - 簡單的文字標記。請指定「t」字元後接自訂網址編碼文字。如要在文字標記中逸出半形逗號，請在半形逗號前方加上 \ 符號。範例：tHello\,+World!
  • A<text>：註解標記。這與標記標記類似，但標記會協調位置，以免重疊。<opt_which_points> 的有效格式為 opt_which_points，用於表示序列中資料點的索引。
  • N<formatting_string> - 這個時間點的資料值，並可選擇套用格式。如果您並未使用 chds 參數 (自訂縮放功能)，則該參數會提供確切的編碼值；如果您將該參數用於「任何格式類型」，系統就會將值縮放為您指定的範圍。請參閱下方含有數值標記的 chds 範例。在堆疊長條圖中，如果為 <series_index> 指定 -1，就會獲得顯示此堆疊長條中所有值總和的標記。格式化字串語法如下：
           <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>。
    這些元素全都為選用元素。以下是每個元素的意義：
    • <preceding_text> - 每個值前面的文字。
    • *...*：以常值星號括住的選用區塊，您可以在其中指定數字的格式詳細資料。系統支援下列值，你不一定要使用這些值：
      • <number_type> - 數字格式的數字格式。選擇下列其中一種交通方式：
        • f - [預設] 浮點格式。建議您使用 <decimal_places> 值來指定精確度。
        • p - 百分比格式。系統會自動附加 % 符號。注意：使用這種格式時，資料值會從 0.0 - 1.0 對應至 0 - 100% (例如，0.43 會顯示為 43%)。
        • e - 科學記號格式。
        • c<CUR>：以指定幣別設定數字格式，並使用適當的貨幣標記。 將 <CUR> 替換為三個字母的貨幣代碼。例如：cEUR 代表歐元。您可以在 ISO 網站查看代碼清單，但系統僅支援部分符號。
      • <decimal_places> - 一個整數，用來指定要顯示的小數位數。這個值會四捨五入 (不會截斷) 至這個長度。預設值為 2。
      • z - 顯示結尾的零。預設值為 no。
      • s - 顯示群組分隔符。預設值為 no。
      • x 或 y：依指定顯示 x 或 y 座標的資料。x 資料的意義因圖表類型而異：您可以用圖表進行實驗，判斷資料的意義。預設值為 'y'。
    • <following_text> - 接續各個值的文字。
<color>
此組合的標記顏色，以 RRGGBB 十六進位格式。
<series_index>
要繪製標記的資料序列的從零開始索引。如果這是堆疊長條圖，且標記類型為 N (資料點值)，您可以指定 -1 來為每個長條堆疊建立加總值標記。請參閱以下範例。
<opt_which_points>
[選用] 要在哪些點上繪製標記。預設值為所有標記。請使用下列其中一個值：
  • n.d - 要繪製標記的資料點，其中「n.d」n.d是序列中從零開始的索引。如果您指定非整數值，分數則代表計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • -1 - 在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有資料點上進行繪製。
  • -n - 在每個「n」n個資料點上繪製標記。
  • start:end:n - 在範圍中的每「n」n個資料點上繪製標記，從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目，因此 3:1 會從第四個元素到最後一個元素，步驟 1 完全省略這個參數，並完全省略這個參數，會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值，從最後一個值反向計算。如果 start 和 end 均為負值，請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1，系統會透過內插資料值來計算其他資料點。預設值是 first:last:1
  • x:y - [N 類型標記不支援]] 在圖表上的特定 x/y 點繪製標記。這個點不必位於線條上。如要在標記類型前加上 in 字元 (@)，請使用這個選項。將座標指定為浮點值，其中 0:0 是圖表左角，0.5:0.5 是圖表的中央，1:1 則是圖表右上角。舉例來說，如要將 15 像素的紅色鑽石加入圖表中央，請使用 @d,FF0000,0,0.5:0.5,15。
<size>
標記的大小，以像素為單位。如果這是包含第三個資料序列的散佈圖 (用來指定點大小)，這個值將依據資料範圍縮放。也就是說，如果資料範圍是 0—100，<size> 為 30，則資料值為 100 的寬度就會是 30 像素，則資料值 50 會寬度為 15 像素，依此類推。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (接近圖表元素上方)。
<opt_placement>
[選用] 其他刊登位置詳細資料，說明標記放置位置 (相對於資料點)。您可以指定水平和/或垂直的相對位置以及偏移值。刊登位置語法是一種字串，其中含有分隔符號，如下所示。所有元素皆為選用元素：<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>。如果有指定，您可以在 <opt_z_order> 的 chm 參數字串中加入空白的 , 值。範例：N,000000,0,1,10,,b、N,000000,0,1,10,,lv 和 N,000000,0,1,10,,r::10。
horizontal_and_vertical_justification
標記的錨點。這的作用與對齊方式相反，因此左側錨點會將標記置於資料點的「右」。您可以從下列清單中選擇水平和/或垂直方向化器：
  • 水平配置：「l」、「h」或「r」：靠左、置中或右錨定，水平位置。預設值為「l」。
  • 垂直放置：「b」、「v」、「t」- 下、中間或頂端錨定廣告。預設值為「b」。
  • 長條圖相關位置 [僅限長條圖]：「s」、「c」、「e」- 基準、中央或頂端長條。以堆疊圖表來說，這是相對於每個系列項目的長條區段，而非整個長條。如果指定的系列索引為 -1 (堆疊總數)，表示該序列與整個長條有關。這可以與直向刊登位置值合併使用，例如「be」或「vs」。 預設值為「e」。
horizontal_offset
此標記的水平偏移，以像素為單位。預設值為 0。
vertical_offset
這個標記的垂直偏移，以像素為單位。非長條圖預設：15；長條圖預設：2。

說明 範例

以下是長條圖上值標籤的範例。

第一個圖表 (N*p0*) 會指定資料值標記，以 11 點文字為單位，所有值會以百分比顯示，四捨五入至小數點後零位數。請注意，資料值會介於 0.0 和 1.0 之間 (使用百分比格式)，往小數點上移動兩位數。

第二個圖表 (N*cEUR1*) 顯示的值與歐元值相同，所有值以黑色為一個小數點後 11 分，以黑色呈現。

長條圖，每個長條上方都有百分比標籤
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091

長條圖，每個長條上方都有歐元標籤


chm=
  N*cEUR1*,000000,0,-1,11

您可以使用 chds 參數調整顯示的數值。所有資料格式都可以使用 chds，包括簡易和延伸編碼。這不會影響長條大小或軸標籤，只會影響資料標記值。

這個範例顯示含有 46、39、29、30、43、41 等簡單編碼值的圖表。簡易編碼範圍介於 0 至 61 之間。chds 參數會定義 0 至 1 的自訂標記比例，因此系統會將標記值縮放至這個範圍，但不影響長條高度 (如果這是文字格式資料，長條也會縮放)。
chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

以下圖表範例在最小點包含文字標籤，並在最大點加入標記標籤。

折線圖顯示 10pt 的藍色文字標籤，以及有 15pt 紅色文字的旗幟，這些文字分別繪製在虛線綠線的資料點上。
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15
這個範例顯示了堆疊圖表，其中含有個別序列的值，以及序列總計。如要顯示堆疊序列值，必須使用「c」定位選項。如未顯示，頂端長條的值會與每個長條頂端的總和值重疊。
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
直向和橫向刊登位置運作方式的更多示範。 這個範例說明長條圖 (使用 s、c 和 e 代表垂直刊登位置) 錨定值的各種組合。請注意右錨點將標記向左移動，頂錨點會將標記向下移動，反之亦然。紅點代表每個長條的底座、中央和頂端。數字是資料值，每個長條使用不同的錨定值固定。
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
註解標記會自動調整標籤位置，以免重疊。第一個 chm 值適用於線條填滿，下列值皆為註解標記。
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
另一個顯示瑞士城市海拔高度的註解標記範例。

返回頁首

範圍標記 chm [長條圖、K 線圖、線條、雷達、散佈圖]

您可以為背景的水平或垂直錶帶加上顏色，藉此凸顯圖表中的特定區域。

您可以使用直立線字元 ( |) 合併任何 chm 標記，藉此分隔 chm 參數組合。

語法

請為每個要繪製的錶帶指定下列一組參數。如要繪製多個頻帶，請建立其他參數組合，並以直立線字元分隔。這些範圍會按照指定的順序繪製，因此最後一個繪製的範圍會繪製在先前範圍的上方。

chm=
  <direction>,<color>,0,<start_point>,<end_point>
    |...|
  <direction>,<color>,0,<start_point>,<end_point>
<direction>
指定水平或垂直陰影。使用 r 做為水平範圍，使用 R 表示垂直範圍。
<color>
以 RRGGBB 格式的十六進位數字表示範圍顏色。
0
預留項目 - 必須為零。
<start_point>
範圍的起始位置。
  • 對於「水平」範圍標記，這是 Y 軸上的位置，其中 0.00 是圖表底部，而 1.00 位於圖表頂端。
  • 以「垂直」範圍標記來說，這是 X 軸上的位置，其中 0.00 是圖表的左側，1.00 代表圖表右側。
<end_point>
範圍的結束位置。
  • 對於「水平」範圍標記，這是 Y 軸上的位置，其中 0.00 是圖表底部，而 1.00 位於圖表頂端。
  • 以「垂直」範圍標記來說，這是 X 軸上的位置，其中 0.00 是圖表的左側，1.00 代表圖表右側。

 

例子

說明 範例

範圍標記可以是細線或一種顏色。

  • r,E5ECF9,0,0.75,0.25 - 範圍標記，純藍色，(保留)，圖表高度的 0.5。
  • r,000000,0,0.1,0.11 - 範圍標記，黑色 (保留)，從 Y 軸向上 0.1 開始，結束在 Y 軸上 (細黑線) 0.11。
 折線圖顯示淡藍色水平錶帶從 Y 軸向上延伸到 75% 的
chm=
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

這個範例顯示垂直範圍標記。第一個標記是紅線 (FF0000)，第二個標記是淡藍色錶帶 (A0BAE9)。

 折線圖顯示 X 軸交往 25% 到 75% 的淡藍色垂直錶帶，以及 X 軸沿線 10% 的細直線 10%
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25

標記會按照指定的順序繪製。在這個範例中，您可以看到垂直紅色標記在淡藍色水平標記之前繪製。

 折線圖顯示藍色垂直頻帶和淡藍色水平錶帶，沿著 X 軸和 Y 軸延伸到 25% 至 75%。沿著 x 軸和 y 軸移動的細長直線和細水平黑色線條百分之十
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25|
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

以下折線圖範例使用範圍標記繪製圖表的零線、中點線和頂部較淡的水平線。

 有一條黃色線條和三條水平線的波形圖
chm=
  r,000000,0,0.499,0.501|
  r,000000,0,0.998,1.0|
  r,000000,0,0.0,0.002

返回頁首

K 線標記 chm=F [Bar, Line]

K 線標記表示資料序列中的變異數和方向變化。經常用於顯示一天內的股價。標記中有顯示高和低值的路段，以及特定時間範圍 (通常是一天) 的開盤和結束值。如要進一步瞭解 K 線標記，請參閱這個網頁。

K 線標記是一個由垂直分隔的矩形繪製而成。我們需要四個資料序列來繪製一個 K 線標記，以下是每個序列指定的內容：

  • 系列 1 和 4 分別指定垂直線的底部和頂端。這些數值通常代表當天的低值和最高值。
  • 系列 2 和 3：指定矩形的垂直框線。第 2 層是開盤價，第 3 系列則是結尾值。矩形的顏色取決於高度：當開盤值 (第 2 號) 低於最終值 (第 3 輪) 時，價格會增加，且矩形會預設為實心綠色；開盤值 (第 2 輪) 高於收尾值 (第 3 輪) 時，價格會降低，而矩形會填滿紅色。您只能針對要縮小的矩形指定填滿顏色。指定這個值時，值為增加的矩形會是未填滿 (空白)。請注意，序列 2 可以是矩形頂端或底部，取決於價格上漲或下跌。

您也可以使用直立線字元 ( |) 合併 K 線標記與其他 chm 參數，藉此分隔 chm 參數。

注意：如果您不希望繪製標記時呈現的資料線條，就必須在格式類型後方加上 0。例如：文字格式資料字串中的 chd=t0:10,20,30,40。詳情請參閱複合圖表。

以下範例顯示每個系列叢書的行：

語法

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
F
表示這是 K 線標記。
<opt_declining_color>
[選用] 值降低時，矩形的填滿顏色 (當序列 2 值 > 對應的序列 3 值時)。此為 RRGGBB 格式的十六進位數字。值增加時，矩形會是空白。預設為恆亮綠燈，以恆亮紅色以減少數值 (不得針對增加的值指定自訂填滿顏色)。
<data_series_index>
資料序列索引，為 K 線標記的第一個序列。這個索引從零開始。因此，如果您在此處指定 1，而您有六個序列，那麼第二個、第三、第四和第五種就會用來繪製 K 線標記。
<opt_what_points>
[選用] 指定用來繪製標記的資料點。預設值為所有標記。請使用下列其中一種格式：
  • n.d：在系列的單一點上繪製標記，其中「n.d」n.d是序列中點的索引。如果指定非整數值，分數則代表計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • -1 - 在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有標記上繪圖。
  • -n - 在每個「n」n個資料點上繪製標記。
  • start:end:n - 在範圍中的每「n」n個資料點上繪製標記，從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目，因此 3:1 會從第四個元素到最後一個元素，步驟 1 中完全省略這個參數，則會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值，從最後一個值反向計算。如果 start 和 end 均為負值，請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1，系統會透過內插資料值來計算其他資料點。預設值是 first:last:1
<寬>
所有矩形的寬度，以像素為單位。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。

 

例子

說明 範例

以下是折線圖中含有四個序列的 K 線標記範例。已指定自訂填滿顏色 0000FF (藍色)，當系列 3 中的點小於序列 2 中的對應點時，系統會使用此顏色填滿矩形。

圖表會剪輯第一個和最後一個矩形。如要去除這些值，您可以在第四個 chm 參數中指定 1:4。

請注意，如要隱藏序列行，請注意資料字串中的零：chd=t0。這表示所有圖表資料都用於標記。

<which_point> 參數為空白，會在所有資料點上繪製 K 線。

折線圖上有四條橘色線條和四個財務標記

chd=t0:
  0, 5,10, 7,12, 6|
  35,25,45,47,24,46|
  15,40,30,27,39,54|
  70,55,63,59,80,60
chm=F,0000FF,0,,20

以下是相同的圖表範例，使用預設顏色並移除第一個和最後一個項目。

這是複合圖表，這是折線圖 (基本圖表類型) 和 K 線標記的組合。cht=t:1 中的值 1 表示第一個之後的所有資料序列，都不應以基本圖表類型 (折線圖) 的形式隱藏。chm=F,,1,1:4,20 中的前 1 表示 K 線資料來自第 2、3、4 和 5 序列 (1 為從零開始)。 如要進一步瞭解如何繪製這類複合圖表，請參閱複合圖表。

折線圖，其中一條橘色線條和四個財務標記。
cht=lc
chm=
  F,,1,1:4,20
chd=t1:
  15,40,30,27,39,54|
  ...

返回頁首

線條標記 chm=D [長條圖、K 線圖、線條、雷達、散佈圖]

您可以在圖表中新增用來追蹤資料的線條。這類圖表最常用於複合圖表。

如要新增多行 (或與其他 chm 標記合併)，請使用直立線 ( |) 分隔符號分隔 chm 參數集。您無法使用這項參數製作虛線標記。

語法

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
D
代表這是線條標記。
<color>
線條的顏色，採用 RRGGBB 十六進位格式。
<series_index>
用於繪製線條的資料序列索引。第一個資料序列的資料序列索引為 0，第二個資料序列的 1，依此類推。
<which_points>
序列中要用來繪製線條的點。請使用下列其中一個值：
  • 0 - 使用系列中的所有分數。
  • start:end - 使用從 start 到 end (從零開始計算) 之間的特定範圍點。您也可以使用浮點值指定中繼點，或將 start 或 end 留空，分別表示第一個或最後一個資料點。start 和 end 可以是負值，做為從最後一個值開始的反向索引。如果 start 和 end 均為負值，請務必以遞增的值寫入 (例如 -6:-1)。
<size>
線條的寬度 (以像素為單位)。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。

 

例子

說明 範例

以下是在長條圖上繪製標記線條的範例。Z 軸順序設為 1，因此線條會繪製在長條上方。

這個範例在長條和資料列中都使用相同資料。		 含有折線標記的長條圖
chm=D,0033FF,0,0,5,1
chd=s:1XQbnf4

這和相同的長條圖，但包含折線專用的額外資料序列。以下為複合圖表範例。藉由在 chd 參數中加入其他資料序列，加上一個值至 chd 即可讓圖表「忽略」其他資料序列，藉此繪製複合圖表。

詳情請參閱複合圖表。

 含有折線標記的長條圖
chm=D,0033FF,1,0,5,1
chd=s1:1XQbnf4,43ksfg6

返回頁首

資料函式chfd [全部 chd圖表]

您可以使用 muParser 函式語法，指定要對圖表資料執行的自訂函式。函式使用的資料可能來自以下兩個來源之一：

  • 來自 chd 的資料序列 - 系統會從 chd 的指定序列中提取資料。
  • chfd 參數本身宣告的值範圍 - 您可宣告任意資料範圍的開始、停止和步驟值。

請務必注意，在所有情況下，您必須將輸出內容指派給 chd 中的現有系列，該序列將由函式輸出覆寫。只有在所有函式都經過處理之後，系統才會顯示圖表。因此，如果您將多個函式指派給輸出至同一個資料序列，系統會依指定順序執行函式，但圖表上只會顯示最終函式的輸出內容。請注意，您可以鏈結函式，讓一個函式可做為輸入序列的輸入序列 (由先前函式輸出)。

如要為函式行指派顏色或 chm 標記，請將顏色或標記指派給函式的序列索引。請注意，系統會根據函式處理後的資料來放置標記。

語法

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>
<output_series_index>
chd 中的資料序列索引 (從零開始)，用於寫入函式輸出內容。函式輸出將完全覆寫任何現有資料。如果某個系列並非函式的輸入內容，最佳做法是為該序列指派一個虛擬值。
<function_data>
要繪製的變數和資料。資料可以來自您定義的範圍，或來自其中一個 chd 資料序列。您可以為每個函式指定多個變數，也可以使用多個變數的 ; (分號) 分隔符號。請注意，如果您為單一函式定義了多個變數，且這些變數的點數不同，則該函式會在到達第一個端點時停止。例如，如果函式定義了 x=1 至 5 步驟 1 和 y=1 至 10 步驟 1，則函式會在到達第五點時結束。
    <variable_name>,<input_series_index>
         或
    <variable_name>,<start>,<end>,<step>
  • variable_name - 變數的任意字串名稱。請在 function_string 定義的函式中使用這項參數。
  • input_series_index - 要做為輸入資料的 chd 資料序列索引。
  • start：範圍中的數值起始值。
  • end：範圍的結束數值。
  • step - start 到 end 之間的數字步驟值。 可以是正數或負數，但不能為零。
範例： x,0,100,1 宣告了名為 x 的變數，值為 0、1、2、... 100。x,0,100,1;r,0,3.1,.1 會宣告相同的 x 變數，以及名為 r 的變數，值為 0、0.1、0.2、...、3.0、3.1。 x,0 會宣告名為 x 的變數，這個變數會使用第一個 chd 系列中的資料。function_string 會使用這些變數。除非您在 function_string 中指定這些變數，否則圖表不會標示這些字元。步數越小，圖表就會越順暢。
<function_stringfunction_string>
您的函式 (以 muParser 語法 編寫)。該函式適用於 variable_data 中指定的變數和資料。您只能參照這個本機函式集中宣告的變數，無法參照其他管道式 chfd 參數組合中宣告的變數。不支援匯總 muParser 函式 (最小值、最大值、平均值)。重要事項：請記得在您的函式中使用 %2B，而不是 +！

 

例子

說明 範例

簡單的正弦波。請注意以下事項：

  • chd=t:-1：由於資料是在 chfd 參數中宣告，因此我們為圖表資料使用虛擬變數。
  • chco=FF0000 - 第一個系列叢書指定了紅色。即使不使用 chd 的資料，系統仍會針對該繪製函式使用該序列的對應顏色。
  • chfd=0,x,0,11,0.1,sin(x)*50%2B50 - 我們宣告一個稱為 x 的變數，其值為 0 到 11，以 0.1 遞增。會指派給第一個系列，也就是第一個系列顏色 (FF0000)。套用至 x 的函式是 sin(x) * 50 + 50。請注意我們如何在該函式中對 + 進行編碼。

 

 chfd 指定的正弦波
cht=lc
chd=t:-1
chco=FF0000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chxt=x,y
這一行使用來自 chd 參數的資料。
chd=t:5,10
chfd=0,x,0,x*4

混合函式和非函式行。

請注意系列顏色參數 chco 指定顏色的方式。

請注意函式輸出中標記的位置；資料點從「start」、「end」和「step」開始計算，因此如果範圍是 0 到 11 步驟 0.1，點 0 為 0，點 1 為 0.1，依此類推，直到第 110 點的值為 11。

 一個使用 chfd 的系列，一個使用 chd 做為資料。
chd=t:
  -1
  15,45
chco=
  FF0000,000000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chm=
  c,00A5C6,0,110,10
  a,00A5C6,0,60,10

如要以兩個維度定義函式，請使用 lxy 圖表，指派兩個虛擬序列，並分別指派一個函式。

  • 0,x,0,10,0.1,sin(x)*50%2B50 - 序列 0 (X 軸值) 含有名為 x 的變數，其值為 0 至 10、步驟 0.1 以及函式 sin(x)*50 + 50
  • 0,y,0,10,0.1,sin(y)*50%2B50 - 序列 0 (y 軸值) 含有名為 y 的變數，其值為 0 至 10、步驟 0.1 以及函式 sin(x)*50 + 50
 一個圓形
cht=lxy
chd=t:-1|-1
chfd=
  0,x,0,10,0.1,sin(x)*50%2B50|
  1,y,0,10,0.1,cos(y)*50%2B50

chfd 參數能讓你盡情發揮創意。

請嘗試點選這些圖片，以便在圖表遊樂場中開啟並暢玩這些圖片，一探究竟！

返回頁首