本頁面由 Cloud Translation API 翻譯而成。

Class TableChartBuilder

表格圖表的建構工具。詳情請參閱 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()`	`Chart`	建立圖表。
`enablePaging(enablePaging)`	`TableChartBuilder`	設定是否要啟用透過資料分頁功能。
`enablePaging(pageSize)`	`TableChartBuilder`	啟用分頁功能，並設定每頁的列數。
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	啟用分頁功能，設定每頁的列數和要顯示的第一個表格頁面 (第頁) 以 0 為基準)
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	透過將資料欄順序，因此最右側的資料欄 0 為 0，最後一欄是最左側的資料欄
`enableSorting(enableSorting)`	`TableChartBuilder`	設定是否要在使用者點選欄標題時排序資料欄。
`setDataSourceUrl(url)`	`TableChartBuilder`	設定用來從外部來源 (例如 Google) 擷取資料的資料來源網址試算表。
`setDataTable(tableBuilder)`	`TableChartBuilder`	使用 DataTableBuilder 設定要用於圖表的資料表。
`setDataTable(table)`	`TableChartBuilder`	設定資料表 (其中包含圖表的線條，以及 X 軸標籤)。
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	設定圖表要使用的資料檢視定義。
`setDimensions(width, height)`	`TableChartBuilder`	設定圖表的維度。
`setFirstRowNumber(number)`	`TableChartBuilder`	設定資料表中第一列的資料列編號。
`setInitialSortingAscending(column)`	`TableChartBuilder`	根據資料表的初始排序設定資料欄索引 (遞增)。
`setInitialSortingDescending(column)`	`TableChartBuilder`	根據資料表的初始排序設定資料欄索引 (遞減)。
`setOption(option, value)`	`TableChartBuilder`	設定這張圖表的進階選項。
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	設定是否顯示資料列編號做為表格的第一欄。
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	設定是否要將交替顏色樣式指派給表格圖表中的奇數，甚至是數個列。

內容詳盡的說明文件

`build()`

建立圖表。

回攻員

Chart：Chart 物件，可嵌入文件、UI 元素或做為靜態用途圖片。

`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：這項建構工具適用於鏈結。