![cht=p&chd=s:Uf9a&chs=75x50](https://developers-dot-devsite-v2-prod.appspot.com/static/chart/image/images/chart_263.png?authuser=3&hl=zh-tw)
本文說明如何使用 Chart API 建立圓餅圖。
目錄
圖表專屬功能 |
標準功能 |
總覽
圓餅圖適合用來呈現簡單的部分對整資訊。您可以建立單一序列圓餅圖,讓每個序列由多個配量或多系列同軸圖表組成。
每個數列都描述一個圓餅圖,而每個資料值會指定一個區塊。使用巢狀圓餅圖 (如下所述) 時,請使用多個序列。
如要顯示與片段相關聯的文字,您必須使用圓餅圖標籤或圖表圖例。圓餅圖標籤是圖表周圍的文字,並以線條指向切片。圖例是與顏色相關聯的文字,
標籤 | 圖例 | 標籤與圖例 |
---|---|---|
![]() chl=January|February|March|April |
![]() chdl=January|February|March|April |
![]() chl=January|February|March|April |
值是彼此相對的顯示:因此數值為 1,2,3 的圖表看起來會與值為 100,200,300 的圖表相同。不過,使用文字格式資料時,大於 100 的值會自動裁剪為 100,因此您必須搭配自訂縮放比例使用文字格式,才能正確顯示大於 100 的切片 (使用 chds
參數的最小值/最大值為 chds=0,<max-slice-size>
)。
負值會顯示為適當大小的空白區塊。
圖表類型
您可以建立的圓餅圖有三種常見的類型:平面、同軸或 3D。請使用下列語法指定圓餅圖:
語法
cht=<chart_type>
其中 <chart_type>
是下列其中一種類型:
參數 | 說明 | 範例 |
---|---|---|
|
二維圓餅圖。 僅提供一個資料序列;系統會忽略後續的資料序列。 根據預設,圓餅線段顏色會從深橘色插入淡黃色。按照「系列顏色」一文的說明指定其他顏色。 按照圓餅圖標籤一文所述,使用 Google Chart API 會以圖表大小 ( |
|
|
3D 圓餅圖。 指定資料和格式的方式,方法與指定前述的兩個維度圓餅圖相同。 如果您要在三維圓餅圖中加入標籤,可能需將寬度大小指定為高度大小的 2.5 倍,才能確保標籤完整顯示。 |
|
|
同心圓餅圖。 提供兩個以上的資料序列。 |
|
所有類型 | 資料中的負數會導致「空白」區塊。 | ![]() cht=pc |
系列顏色 chco
您可以使用 chco
參數指定所有值、每個值或部分值的顏色。
語法
chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>
- <color>
- 切片顏色,採用 RRGGBB 十六進位格式。指定單一系列顏色,且該系列中的所有配量都會按照該色彩的色彩從最深 (第一個資料成員) 到最輕 (最後資料成員) 上色。指定兩個以上的顏色,並以 | 分隔,以描述個別片段顏色。如果您有多個序列 (也就是採用同心圓環的圖表),可以用逗號分隔值分隔值,為不同的序列指定值。如果提供的配量/序列顏色少於顯示的部分/系列,圖表會從系列的配量清單開頭或圖表的系列清單開頭。您無法在多系列圖表中為每個序列指定不同的漸層。
說明 | 範例 |
---|---|
指定單一顏色,從最暗 (第一個切片) 到最輕 (最後一個切片)。 |
|
定義漸層;從黃色到紅色。 | ![]()
|
定義個別區塊顏色;每個切片指定一種顏色。 | ![]() chd=t:10,20,30 |
這張圖表有兩個資料序列,但從黃色到紅色 (BBBB00 - BB0000) 的所有配量中,將顏色指定為單一漸層。 | ![]() chco=BBBB00,BB0000 |
以下是包含系列顏色和個別切片顏色的同心圖。圖表包含兩個同軸資料序列。 人類可讀的顏色是 chco=綠色|紅色,藍色|黃色。逗號會將此部分分成兩個系列:
|
![]() chd=s:eYY,ORVM |
圓餅圖標籤chl
您可以使用 chl
參數為個別圓餅圖配量指定標籤。您也可以顯示具有相同或不同值的圖例,每個片段一個圖例項目。
字串值注意事項:標籤字串只能使用安全網址字元。為了安全起見,如果字串含有字元集 0-9a-zA-Z
內的字元,請進行網址編碼。您可以在這裡找到網址編碼器。
語法
chl= <label_value>| ... <label_value>
- <label_value>
- 要套用至配量的字串值。標籤會連續套用至
chd
中的資料點。如果您有多個序列 (例如同心圓餅圖),標籤會依照chd
中指定的順序套用至所有序列的所有點。請在每個標籤之間使用直立線分隔符號 (|
)。使用兩個連續的管道字元 (中間不留空格),藉此指定缺少的間隔值:||
。您不需要為所有配量加上標籤。
例子
說明 | 範例 |
---|---|
三維圓餅圖的標籤。 |
|
使用 一般來說,2D 圓餅圖的寬度需為高度的兩倍,而 3D 圓餅圖的寬度則要比高的兩半左右,才能正確顯示標籤。 在第一個範例中,由於圖表寬度不夠,因此標籤只會顯示部分標籤。 第二個範例顯示圖表的寬度需為 280 像素,才能完整顯示標籤。(已明確在 |
|
旋轉圓餅圖 chp
根據預設,第一個序列是從 3:00 開始繪製,依順時針方向繼續繪製圖表,但您可以使用 chp
參數指定自訂旋轉。
語法
chp=<radians>
- <radians>
- 這個浮點值說明圖表順時針旋轉的弧度。一整輪為 2π (2 圓,約 6.28) 弧度。
例子
說明 | 範例 |
---|---|
如要變更圓餅圖的方向,請使用 |
|
以下是另一個圓餅圖旋轉的範例。這些圖片可以與圖表形狀標記搭配使用,可產生一些有趣的效果。 | ![]() |
標準功能
本頁其他功能為標準圖表功能。
圖表標題 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、satter]
您可以指定要在圖表中顯示的軸,並提供自訂標籤、位置、範圍和樣式。
並不是所有圖表預設顯示軸線。您可以使用 chxt
參數明確指定圖表要顯示的軸。預設軸線不會顯示數字;您必須在 chxt
參數中指定軸以顯示數字。
您可以選擇讓軸顯示代表資料值的數字,或指定自訂軸。預設會顯示數值,且值的範圍從 0 到 100。不過,您可以使用 chxr
變更這個範圍以顯示任何範圍,也可以使用 chxs
設定值的樣式 (例如顯示貨幣符號或小數位數)。
如果您選擇使用自訂值 (例如:「Mon, Tues, Wed」),則可以使用 chxl
參數。如要將這些標籤沿著軸的特定位置放置,請使用 chxp
參數。
最後,您可以使用 chxs
和 chxtc
參數指定自訂和數字軸標籤的顏色、大小、對齊方式和其他屬性。
字串值注意事項:標籤字串只能使用安全網址字元。為了安全起見,如果字串含有字元集 0-9a-zA-Z
內的字元,請進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。
本節涵蓋下列主題:
- 「Visible Axes」 (
chxt
):要顯示的軸。 - 軸範圍 (
chxr
) - 每軸的值範圍。 - 自訂軸標籤 (
chxl
):要顯示在軸上的自訂值。 - 軸標籤位置 (
chxp
) - 每個軸上的自訂標籤位置。 - 軸標籤樣式 (
chxs
) - 軸標籤的顏色、大小、對齊方式和格式設定。 - 軸標記樣式 (
chxtc
):特定軸的刻點長度。
顯示的軸 chxt
根據預設,長條圖、折線圖、雷達圖和散佈圖會顯示一或兩條軸線,但這些線條不包含值。如要在軸線上顯示值,或是變更顯示軸,您必須使用 chxt
參數。根據預設,軸值的範圍介於 0 到 100 之間,除非您使用 chxr
屬性明確縮放。如要隱藏折線圖中的所有軸線,請在 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.0x1x2 />" <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.0x27" |
這個範例顯示有 x 軸、Y 軸、上 T 軸和右 r 軸的水平長條圖。 軸標籤會省略,因此 Chart API 會顯示 0 到 100 的範圍 (X 軸和 t 軸)。 Y 軸和 r 軸的範圍取決於長條數。在本例中,圖表有五個長條,因此 Chart API 會顯示介於 0 到 4 的範圍。第一個標籤位於第一個長條的底部,第二個標籤則位於第二個長條的底部,依此類推。 |
|
您可以在圖表類型後方指定 :nda ,藉此隱藏折線圖中的預設軸。 |
![]() cht=lc:nda |
軸範圍 chxr
您可以使用 chxr 參數指定每個軸獨立顯示的值範圍。請注意,這項操作「不會」 變更圖表元素的比例,只會變更軸標籤的比例。如想用軸編號描述實際資料值,請將 <start_val> 和 <end_val> 分別設為資料格式範圍的下限和上限值。詳情請參閱「軸縮放」。
如要指定某軸的範圍,必須使用 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>
- [選用] 軸上刻點之間的計數步數。沒有預設步數值,會計算該步驟以顯示一組適當間距的標籤。
例子
說明 | 範例 |
---|---|
這個範例顯示左右軸 ( 每個軸都有定義範圍。由於您未指定任何標籤或位置,因此值會從指定的範圍取得,且會在該範圍內保持等距。在折線圖中,各值會沿著 X 軸平均分散。 由於第一個值 ( |
|
在這個範例中,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
,則第一個 x 軸會是索引 0,第二個 x 軸則是 1。 - <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
,第一個 x 軸就會是 0,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_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>
- [選用;不支援 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_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,約為 50%)。請注意整張圖表中的表格儲存格背景。 |
|
漸層填滿 chf
[Line、Bar、Google-o-meter、Radar、Satter、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、Satter、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= |
資料函式 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,則該函式會在到達第 5 個點時結束。
<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
變數,以及值為 0、0.1、0.2、...、3.0、3.1 的r
變數。x,0
會宣告名為 x 的變數,這個變數會使用第一個chd
序列的資料。function_string 會使用這些變數。 除非您在 function_string 中指定這些變數,這些物件才會繪製在圖表上。 步數越小,圖表越順暢。 - <function_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 |
歡迎點選這些圖片,在圖表遊樂場裡盡情使用,即可開始暢玩! |