表格圖表的建構工具。詳情請參閱 Google 圖表說明文件。
以下範例說明如何建立表格圖表。資料是從 Google 試算表匯入。
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var chartBuilder = Charts.newTableChart() .setDimensions(600, 500) .enablePaging(20) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
方法
內容詳盡的說明文件
build()
enablePaging(enablePaging)
設定是否要啟用資料分頁功能。
預設行為是停用分頁功能。如果已啟用分頁功能,預設頁面大小為 10。
參數
名稱 | 類型 | 說明 |
---|---|---|
enablePaging | Boolean | true 表示應啟用分頁,false 否則。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
enablePaging(pageSize)
啟用分頁功能,並設定每個頁面中的資料列數量。
預設頁面大小為 10 個。
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
參數
名稱 | 類型 | 說明 |
---|---|---|
pageSize | Integer | 表格每一頁的列數。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
enablePaging(pageSize, startPage)
啟用分頁功能,設定每個網頁以及第一個表格頁面要顯示的列數 (頁碼為零)。
預設頁面大小為 10,預設起始頁面為 0。
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
參數
名稱 | 類型 | 說明 |
---|---|---|
pageSize | Integer | 表格每一頁的列數。 |
startPage | Integer | 要顯示的第一個表格頁面 (頁碼從零開始)。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
enableRtlTable(rtlEnabled)
透過反向排序資料表的資料欄順序,新增由右至左語言 (例如阿拉伯文或希伯來文) 的基本支援,讓零欄成為最右欄,而最後一欄就是最左邊的資料欄。
這不會影響基礎資料中的資料欄索引,只會影響顯示順序。即使選取這個選項,資料表視覺化功能仍不支援全雙向 (BiDi) 語言顯示功能。如果您啟用分頁功能 (使用頁面選項),或由於您指定的高度和寬度選項小於必要資料表大小,因此系統會忽略這個選項。預設行為為停用 RTL 支援。
參數
名稱 | 類型 | 說明 |
---|---|---|
rtlEnabled | Boolean | 如果應啟用由右至左支援,則為 true ,否則為 false 。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
enableSorting(enableSorting)
設定是否要在使用者點選欄標題時排序資料欄。
如果啟用排序功能,則當使用者按下欄標題時,系統就會自動排序資料列。預設行為已啟用排序功能。
參數
名稱 | 類型 | 說明 |
---|---|---|
enableSorting | Boolean | true 可按一下欄標題來啟用排序功能,否則點選 false 即可。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setDataSourceUrl(url)
設定用來從外部來源 (例如 Google 試算表) 擷取資料的資料來源網址。如果提供資料來源網址和 DataTable,系統就會忽略資料來源網址。
如要進一步瞭解如何查詢資料來源,請參閱 Google 圖表說明文件。
參數
名稱 | 類型 | 說明 |
---|---|---|
url | String | 資料來源網址 (包括任何查詢參數)。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setDataTable(tableBuilder)
使用 DataTableBuilder 設定要用於圖表的資料表。此方式可讓您輕鬆設定資料表,無需呼叫 build()
。
參數
名稱 | 類型 | 說明 |
---|---|---|
tableBuilder | DataTableBuilder | 資料表建構工具。系統會在這項呼叫中立即建立新的資料表,因此任何關於建構工具的進一步更新都不會反映在圖表中。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setDataTable(table)
設定包含圖表線條的資料表格,以及 X 軸標籤。第一欄應為字串,且包含水平軸標籤。後續可加入的資料欄數量不拘,所有欄都必須是數字。每一欄會單獨顯示為一行。
參數
名稱 | 類型 | 說明 |
---|---|---|
table | DataTableSource | 要用於圖表的資料表。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setDataViewDefinition(dataViewDefinition)
設定要用於圖表的資料檢視定義。
參數
名稱 | 類型 | 說明 |
---|---|---|
dataViewDefinition | DataViewDefinition | 資料檢視定義物件,用來定義應從圖表繪圖的特定資料來源衍生的檢視畫面。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setDimensions(width, height)
設定圖表的維度。
參數
名稱 | 類型 | 說明 |
---|---|---|
width | Integer | 圖表的寬度,以像素為單位。 |
height | Integer | 圖表的高度,以像素為單位。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setFirstRowNumber(number)
設定資料表中第一列的資料列編號。
第一列的預設資料列編號為 1。
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
參數
名稱 | 類型 | 說明 |
---|---|---|
number | Integer | 資料表中第一列的列號。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setInitialSortingAscending(column)
設定資料欄的索引,是根據資料表一開始的排序依據 (遞增)。
資料欄 OS 依遞增順序排序,並會以小箭頭表示。
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
參數
名稱 | 類型 | 說明 |
---|---|---|
column | Integer | 資料表最初排序時依據的資料欄數量。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setInitialSortingDescending(column)
設定資料欄的索引,是根據資料表一開始的排序方式 (遞減)。
資料欄 OS 以遞減順序排序,並標有小箭頭,代表此資料欄。
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
參數
名稱 | 類型 | 說明 |
---|---|---|
column | Integer | 資料表最初排序時依據的資料欄數量。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
setOption(option, value)
設定這張圖表的進階選項。請參閱此圖表的可用選項。如果指定的選項無效,這個方法就不會有任何作用。
// Build a table chart which renders HTML. var builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); var chart = builder.build();
參數
名稱 | 類型 | 說明 |
---|---|---|
option | String | 要設定的選項。 |
value | Object | 要設定的值。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
showRowNumberColumn(showRowNumber)
設定是否將資料列編號顯示為表格的第一欄。
預設行為不會顯示資料列編號。
參數
名稱 | 類型 | 說明 |
---|---|---|
showRowNumber | Boolean | 如果資料表的第一欄應顯示列編號,則為 true ,否則為 false 。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。
useAlternatingRowStyle(alternate)
設定是否在表格圖中將交替顏色樣式指派給奇數或偶數。
預設行為是會交替顏色樣式的資料列。
參數
名稱 | 類型 | 說明 |
---|---|---|
alternate | Boolean | 如果應交替顏色樣式,則為 true ,否則為 false 。 |
回攻員
TableChartBuilder
— 這個建構工具適用於鏈結。