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

Class TableChartBuilder

表格圖表的建構工具。詳情請參閱 Google 圖表說明文件。

以下範例說明如何建立表格圖表。資料是從 Google 試算表匯入。

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

方法

方法	傳回類型	簡短說明
`build()`	`Chart`	建構圖表。
`enablePaging(enablePaging)`	`TableChartBuilder`	設定是否啟用資料分頁功能。
`enablePaging(pageSize)`	`TableChartBuilder`	啟用分頁功能，並設定每個頁面中的資料列數量。
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	啟用分頁功能，設定每個頁面的列數和要顯示的第一個表格頁面 (頁碼以零為基底)。
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	透過反轉表格的欄順序，為由右至左的語言 (例如阿拉伯文或希伯來文) 新增基本支援功能，讓第 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：圖表物件，可嵌入文件、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.
const 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.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

參數

名稱	類型	說明
`pageSize`	`Integer`	資料表每頁的資料列數。
`startPage`	`Integer`	要顯示的第一個表格頁面 (頁碼以 0 為基底)。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`enableRtlTable(rtlEnabled)`

為由右至左的語言 (例如阿拉伯文或希伯來文) 新增基本支援功能，方法是將表格的欄順序倒轉，讓第 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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

參數

名稱	類型	說明
`number`	`Integer`	資料表中第一列的列號。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`setInitialSortingAscending(column)`

根據表格應最初以遞增方式排序的欄，設定該欄的索引。

資料欄以遞增順序排序，並標示有小箭頭。

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

參數

名稱	類型	說明
`column`	`Integer`	資料表應以哪個資料欄進行初始排序。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`setInitialSortingDescending(column)`

設定表格應依據哪個欄進行初始排序 (遞減)。

資料欄以遞減順序排序，並標示有小箭頭。

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

參數

名稱	類型	說明
`column`	`Integer`	資料表應以哪個資料欄進行初始排序。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`setOption(option, value)`

設定這張圖表的進階選項。請參閱這張圖表的可用選項。如果指定的選項無效，這個方法就不會生效。

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

參數

名稱	類型	說明
`option`	`String`	要設定的選項。
`value`	`Object`	要設定的值。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`showRowNumberColumn(showRowNumber)`

設定是否要將資料列號碼顯示為表格的第一欄。

預設行為是不會顯示資料列數。

參數

名稱	類型	說明
`showRowNumber`	`Boolean`	`true` 如果表格的第一欄應顯示列號，則為 `false`，否則為 `false`。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。

`useAlternatingRowStyle(alternate)`

設定是否將交替顏色樣式指派給表格圖表的奇數和偶數列。

預設行為是使用交替色彩樣式。

參數

名稱	類型	說明
`alternate`	`Boolean`	如果應交替顯示顏色樣式，請使用 `true`，否則請使用 `false`。

回攻員

TableChartBuilder：這個建構工具可用於鏈結。