表格圖表的建構工具。詳情請參閱 Google 圖表說明文件。
以下範例說明如何建立表格圖。資料由從 Google 試算表匯入。
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1:F' '&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)
啟用分頁功能,設定每頁的列數和要顯示的第一個表格頁面 (第 頁) 以 0 為基準)
預設頁面大小為 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 | 要顯示的第一個表格頁面 (頁碼從 0 開始)。 |
回攻員
TableChartBuilder
:這項建構工具適用於鏈結。
enableRtlTable(rtlEnabled)
透過將 資料欄順序,因此最右側的資料欄 0 為 0,最後一欄是 最左側的資料欄
這不會影響基礎資料中的欄索引,只會影響顯示的順序。 表格視覺呈現不支援完整雙向 (BiDi) 語言顯示 使用此選項如果您啟用分頁功能 (使用網頁選項),或 表格含有捲軸,因為您指定的高度和寬度選項小於 必要的資料表大小預設行為為停用 RTL 支援功能。
參數
名稱 | 類型 | 說明 |
---|---|---|
rtlEnabled | Boolean | 如果應啟用由右至左支援,請設為 true ,false
反之。 |
回攻員
TableChartBuilder
:這項建構工具適用於鏈結。
enableSorting(enableSorting)
設定是否要在使用者點選欄標題時排序資料欄。
如果啟用排序功能,當使用者按一下欄標題時,資料列就會自動 排序預設行為是啟用排序功能。
參數
名稱 | 類型 | 說明 |
---|---|---|
enableSorting | Boolean | true 可按一下欄標題啟用排序,否則使用 false 即可。 |
回攻員
TableChartBuilder
:這項建構工具適用於鏈結。
setDataSourceUrl(url)
設定用來從外部來源 (例如 Google) 擷取資料的資料來源網址 試算表。如有提供資料來源網址和資料表,系統就會忽略資料來源網址。
如要進一步瞭解如何查詢資料來源,請參閱 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
:這項建構工具適用於鏈結。