本文說明如何使用 Chart API 建立散佈圖。
目錄
圖表專屬功能 |
標準功能 |
簡介
散佈圖 (或散佈圖) 是 2D 圖表上的一組個別圓點。您可以選擇指定個別圓點的大小。散佈圖只能接受一個資料序列。如果多個資料點包含兩個變數,散佈圖就很適合用於偵測分組或模式 (如果您只有一個變數,請考慮使用折線圖)。
您必須提供至少兩個資料序列:第一個資料序列指定 x 座標,第二個資料序列則指定 y 座標。
您可以選擇提供第三個系列系列來指定個別的點大小。如果沒有這個系列,所有點都會預設為 10 像素。
請注意,如果您使用 chm
修改資料點的形狀或顏色,則點會根據 chm
中提供的大小縮放。
圖表類型 (cht
)
使用下列語法指定散佈圖:
語法
cht=s chd=<x_values>|<y_values>[|<optional_point_sizes>]
說明 | 範例 |
---|---|
資料點的預設標記是藍色圓圈。如要使用其他顏色或形狀,請按照本節其他章節所述的 這張圖表加入了第三個資料序列,用來調整資料點大小。 |
|
如要使用顏色模擬多個序列,請使用 此圖表包含三個資料序列:第一個是 x 值,第二個是對應的 y 值,第三個是對應的點大小。
圖例是使用 |
chd=t: |
如要改變點的形狀,請使用形狀標記。視其在
以下是形狀標記的其他使用提示:
|
chm=d,FF0000,0,-1,15 將預設形狀設為菱形 (d) chm= 預設值為菱形 ( d ),標記索引 15 以上為覆蓋菱形的正方形 (s )。chd=t: |
您也可以新增線條標記 (
|
chd=t:
|
以下說明如何在不依賴可見點的情況下,建立跨點追蹤線:
散佈圖無法做為複合圖表使用,因此無法新增額外序列來描述線條。 這種方法無法指定虛線,但您可以指定線條顏色和粗細。 |
隱藏點的追蹤行:chd=t: |
序列顏色 chco
使用 chco
參數指定點的顏色。您可以為所有點、漸層或個別點指定單一顏色。
語法
chco=<single_color> or chco=<point_1_color>|...|<point_n_color> or chco=<gradient_start>,...,<gradient_end> (only with third data series)
- <color>
- 點的顏色,以 RRGGBB 十六進位格式。以下列舉幾種不同的格式:
- 指定套用至所有點的單一顏色。
- 如要為個別點套用個別顏色,請使用直立線分隔符號,為每個點指定一個顏色。
- 如果您指定個別圓點顏色,但顏色少於點號,則系統會為每個「第 n 個」點指派對應的第 n 種顏色。這就是建立多個序列散佈圖的方法。
- 如要套用顏色漸層,您必須加入第三個資料序列 (用來決定點大小)。加入兩個以上的顏色 (以半形逗號分隔),以便根據圓點大小為點套用顏色漸層。
標準功能
本頁其餘功能是標準圖表功能。
圖表標題 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」。
例子
說明 | 範例 |
---|---|
包含標題的圖表,使用預設顏色和字型大小。 請使用加號 ( 使用直立線字元 ( 此處並未指定「 |
chtt=Site+visitors+by+month| |
此圖表顯示藍色、靠右對齊且有 20 點的標題。 |
chtt=Site+visitors |
圖表圖例文字和樣式 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
chdl=First|Second|Third |
第一張圖表展示水平圖例項目 ( |
|
這個範例說明如何變更字型大小。 |
|
圖表利潤 chma
[所有圖表]
您可以用像素指定圖表邊界的大小。邊界是根據指定圖表大小 (chs
) 進行計算;增加邊界大小不會增加圖表總大小,而是會在必要時縮小圖表區域。
根據預設,邊界為計算圖表大小後剩餘的內容。 這個預設值會因圖表類型而異。您指定的邊界為「最小值」;如果圖表區域保留空間空間,邊界大小會是剩餘的內容;您無法擠壓小於任何圖例和標籤所需範圍的邊界。下圖顯示圖表的基本部分:
「圖表邊界」包括「軸標籤」和「圖例區域」。除非您使用 提示:在長條圖中,如果長條的尺寸固定 (預設值),就無法縮減圖表區域寬度。您必須使用 |
語法
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 像素,因此右側邊界會設為圖表圖例的寬度,與其他邊界不同。 軸標籤位於繪製區域之外,因此會在邊界空間中繪製。 |
|
如要在圖例周圍新增邊界,請設定 在這個範例中,圖例的寬度約為 60 像素。如果您將 |
|
軸樣式和標籤 [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
):要顯示的軸。 - 軸範圍 (
chxr
):每個軸的值範圍。 - 自訂軸標籤 (
chxl
):要顯示在軸上的自訂值。 - 軸標籤位置 (
chxp
) - 自訂標籤在每個軸上的位置。 - 軸標籤樣式 (
chxs
) - 軸標籤的顏色、大小、對齊方式和格式設定。 - 軸刻度標記樣式 (
chxtc
) - 特定軸的刻度記號長度。
可見軸 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 範圍。 請注意,根據預設,頂端和底部軸不會在標籤顯示勾號。 |
|
您可以重複加入相同的值,為每個軸加入多組標籤。這個範例顯示兩組 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,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%20%23 |
這個範例顯示包含 X 軸、Y 軸、上 T 軸和右側 r 軸的水平長條圖。 系統會省略軸標籤,因此 Chart API 會在 X 軸和 T 軸顯示 0 到 100 的範圍。 Y 軸和 r 軸的範圍取決於長條數量。在本範例中,共有五個長條,因此圖表 API 會顯示 0 到 4 的範圍。第一個標籤會置於第一個長條的中心,第二個標籤則位於第二個長條的底部,以此類推。 |
|
只要在圖表類型後方指定 :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 軸 ( 每個軸都有定義的範圍。由於未指定任何標籤或位置,因此值會從指定範圍內取得,且會在該範圍內平均間距。在折線圖表中,各個值會沿著 X 軸平均分配。 r 軸 (索引 |
|
在本例中,X 軸指定的值。 軸標籤會沿著軸平均間隔。<opt_step> 參數的值為五 ( |
|
自訂軸標籤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
參數的最後一個標籤後方放置直立線。
例子
說明 | 範例 |
---|---|
這張圖表顯示如何在兩個軸上新增自訂標籤。請注意這些值的間距方式,以及最後一個 |
chxt=x,y |
這個範例包含左右 Y 軸 ( |
|
這個範例包含左右 Y 軸的軸標籤 ( 這個範例使用左側 Y 軸上的軸標籤預設值。 |
|
如果您想加入一般標籤來描述整個軸 (例如為某軸「費用」和「學生」加上標籤),請使用 |
chxt=x,x,y,y |
軸標籤位置 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 軸標籤。標籤文字是使用 指定位置為 指定位置為 |
|
這個範例說明顯示預設標籤值,但只會在指定位置顯示。
|
chxt=x,y
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 月) 已指定字型大小和顏色。 |
|
字型大小、顏色和對齊方式是在右側 Y 軸上。繪製是沒有軸線的勾號。 |
|
這張圖表包含三個資料集,並顯示三組軸標籤 (每個序列一個)。每一組標籤都會使用自訂格式設定字串格式化,如下所示:
軸標籤範圍是使用 |
chd=s: |
軸線標記樣式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 會指定 Y 軸 (5 和 15) 的兩個刻點長度值,而圖表上繪製的刻度在兩個值之間會交替使用。 |
chxt=x,y |
背景填滿 chf
[所有圖表]
您可以指定圖表資料區域和/或整個圖表背景的填滿顏色和樣式。填滿類型包括單色、條紋填滿和漸層。您可以為不同區域指定不同的填滿 (例如整個圖表區域,或僅限資料區域)。圖表區域填滿會覆寫背景填滿效果。所有填滿效果都是使用 chf
參數指定,而且您可以在同一個圖表中混用不同的填滿類型 (單色、條紋、漸層)。以直線字元 ( | ) 分隔值。圖表區域會填滿圖表背景填滿效果。
填滿填滿chf
[所有圖表]
您可以為背景和/或圖表區域指定實心填滿,或為整個圖表指派透明度值。您可以使用直立線字元 (|
) 指定多個填色 (地圖:僅限背景)。
語法
chf=<fill_type>,s,<color>|...
- <填入類型fill_type>
- 圖表中填滿的部分。你可以指定下列其中一個值:
bg
- 背景填滿c
- 圖表區域填滿。不支援地圖圖表。a
- 將整個圖表 (包括背景) 設為透明。系統會忽略<color>
的前六位數,且只會將最後兩位數 (透明度值) 套用至整個圖表和所有填滿效果。b<index>
- 長條純填滿 (僅限長條圖)。將 <index> 替換為長條的序列索引,以填入單色。效果與在長條圖中指定chco
類似。如需範例,請參閱長條圖圖表系列顏色。
- 秒
- 代表實心或透明度填滿。
- <color>
- 填滿顏色,採用 RRGGBB 十六進位格式。如果是轉碼,系統會忽略前六位數,但仍必須加入。
例子
說明 | 範例 |
---|---|
這個範例會以灰色 ( |
|
這個範例會以淡灰色 ( |
|
這個範例對整個圖表套用 50% 的透明度 (128 十六進位數字 80 或約 50%)。請注意,透過圖表顯示的表格儲存格背景。 |
|
漸層填滿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> 指定的角度。
例子
說明 | 範例 |
---|---|
圖表區域具有水平線性漸層,並以零度 ( 顏色為桃紅色 ( 圖表背景會以灰色 ( |
|
圖表區域採用對角線 (從左下到右下方) 線性漸層,指定的角度為四十五度 ( 桃紅色 ( 藍色 ( 圖表背景會以灰色 ( |
|
圖表區域具有垂直 (由上至下) 線性漸層,其角度為九十度 ( 藍色 ( 桃紅色 ( 圖表背景會以灰色 ( |
|
條紋填滿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>。至少須有兩條條紋。除非填滿圖表,否則會進行替換。
例子
說明 | 範例 |
---|---|
|
chf= |
|
chf= |
格線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。
例子
說明 | 範例 |
---|---|
這些範例只會使用 |
chg=20,50 chg=20,50 |
此範例使用較大的空格來顯示較淺的格線 ( |
|
如要顯示實線格線,請將 此外,這張圖表的 X 軸偏移值是 10。 |
chg=20,50,1,0,10 |
此圖表顯示 X 軸偏移值 10,y 軸偏移為 20。 |
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: 圖表 2: |
|
請注意,動態圖示標記的水平和垂直置中。因此,如果您使用含有尾數的動態圖示,尾部並不會位於圖表點上,因此標記中心為。第一張圖表將標記置於資料點 3 的中心,該資料點實際上將尾部稍微放在線條上的標記右側。 第二個圖表使用 |
chem=y;
chem=y; |
如要加入多個動態圖示,請重複使用 | 字元分隔的語法字串。 這個範例顯示一個範圍以及兩個個別標記。 請注意垂直圖釘與 0,22 之間的位移,傾斜圖釘的偏移值則為 12,20,讓圖釘與所描述的序列對齊。 |
chem= |
這說明瞭多行文字標記。新增文字後,標記必須偏移,因為對話框會依照文字調整大小,進而在圖表上重新置中。請注意,在 d 資料字串中,文字中的換行符號會以半形逗號表示。 |
chem=y; |
內嵌圖表
您可以使用動態圖示語法,將圖表嵌入其他圖表。
嵌入圖表標記有兩種樣式:嵌入泡泡中的圖表,以及不含泡泡的嵌入式圖表。以下是這兩種網址的範例:
含有泡泡的圖表 |
不含泡泡的圖表 |
以下是 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¶meter2=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:1x: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>
:指定垂直偏移的正數或負數,以像素為單位。選用;如未使用,請留空。
例子
說明 | 範例 |
---|---|
以下是幾種形狀和線條標記的範例。
|
chm= |
以下舉例說明一個資料序列使用菱形的方法,以及其他資料序列的圓形。 如果多個標記位於相同點,則系統會依照標記在 |
chm= |
折線圖是每秒一個資料點 (-2 代表所有其他點)。 |
chd=t: |
以下是折線圖,標記數量是資料點的兩倍 (-0.5 代表每半點)。 | chd=t: |
這個範例說明如何使用 h 和 v 標記,建立自訂顏色和粗細的格線。Z 軸值 (最後一個值) 會設為 -1,這樣就會在資料行下方繪製格線。 |
chm= |
這張圖表會在折線圖中加入垂直填滿線:
|
chm= |
這個範例會使用確切座標,在圖表中加入箭頭和文字標記。第一個 D 標記是長條下方的追蹤記錄行,第二個標記是箭頭,第三個標記是箭頭文字。 | chm= |
固定為特定資料點的水平線 (H ) 很適合用來顯示相對值,或強調圖表中資料值的高度。 |
chm=H,FF0000,0,18,1 |
這張圖表展示了可在 <size> 參數中指定線條粗細和長度的標記。
|
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= |
文字和資料值標記 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:1x: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。
說明 | 範例 | |
---|---|---|
以下是長條圖上值標籤的範例。 第一個圖表 ( 第二個圖表 ( |
|
|
您可以使用 這個範例顯示含有 46、39、29、30、43、41 等簡單編碼值的圖表。簡易編碼範圍介於 0 至 61 之間。 |
chd=s:underp |
|
以下圖表範例在最小點包含文字標籤,並在最大點加入標記標籤。 |
|
|
這個範例顯示了堆疊圖表,其中含有個別序列的值,以及序列總計。如要顯示堆疊序列值,必須使用「c」定位選項。如未顯示,頂端長條的值會與每個長條頂端的總和值重疊。 | chm= |
|
直向和橫向刊登位置運作方式的更多示範。 這個範例說明長條圖 (使用 s、c 和 e 代表垂直刊登位置) 錨定值的各種組合。請注意右錨點將標記向左移動,頂錨點會將標記向下移動,反之亦然。紅點代表每個長條的底座、中央和頂端。數字是資料值,每個長條使用不同的錨定值固定。 | chm= |
|
註解標記會自動調整標籤位置,以免重疊。第一個 chm 值適用於線條填滿,下列值皆為註解標記。 |
chm=B,C5D4B5BB,0,0,0 |
|
另一個顯示瑞士城市海拔高度的註解標記範例。 |
範圍標記 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
代表圖表右側。
例子
說明 | 範例 |
---|---|
範圍標記可以是細線或一種顏色。
|
|
這個範例顯示垂直範圍標記。第一個標記是紅線 ( |
|
標記會按照指定的順序繪製。在這個範例中,您可以看到垂直紅色標記在淡藍色水平標記之前繪製。 |
chm= |
以下折線圖範例使用範圍標記繪製圖表的零線、中點線和頂部較淡的水平線。 |
|
線條標記 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 軸順序設為 |
chm=D,0033FF,0,0,5,1 |
這和相同的長條圖,但包含折線專用的額外資料序列。以下為複合圖表範例。藉由在 詳情請參閱複合圖表。 |
chm=D,0033FF,1,0,5,1 |
資料函式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
,而不是+
!
例子
說明 | 範例 |
---|---|
簡單的正弦波。請注意以下事項:
|
cht=lc |
這一行使用來自 chd 參數的資料。 |
chd=t:5,10 |
混合函式和非函式行。 請注意系列顏色參數 請注意函式輸出中標記的位置;資料點從「start」、「end」和「step」開始計算,因此如果範圍是 0 到 11 步驟 0.1,點 0 為 0,點 1 為 0.1,依此類推,直到第 110 點的值為 11。 |
chd=t: |
如要以兩個維度定義函式,請使用
|
cht=lxy |
請嘗試點選這些圖片,以便在圖表遊樂場中開啟並暢玩這些圖片,一探究竟! |