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

Class TableChartBuilder

表格圖表的建構工具。詳情請參閱 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()`	`Chart`	建立圖表。
`enablePaging(enablePaging)`	`TableChartBuilder`	設定是否要啟用資料分頁功能。
`enablePaging(pageSize)`	`TableChartBuilder`	啟用分頁功能，並設定每個頁面中的列數。
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	啟用分頁功能，設定每個網頁以及第一個表格頁面要顯示的列數 (頁數為零)。
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	透過反向排序資料表的資料欄順序，新增由右至左語言 (例如阿拉伯文或希伯來文) 的基本支援，讓零欄位於最右欄，而最後一欄就是最左邊的資料欄。
`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.
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 — 這個建構工具適用於鏈結。