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`	新增對由右至左語言 (例如阿拉伯文或希伯來文) 的基本支援，方法是反轉表格的欄順序，讓第零欄成為最右側的欄，最後一欄則成為最左側的欄。
`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`	要顯示的第一個表格頁面 (頁碼以零為基準)。

回攻員

TableChartBuilder - 這個建構工具適用於鏈結。

`enableRtlTable(rtlEnabled)`

新增對由右至左語言 (例如阿拉伯文或希伯來文) 的基本支援，方法是反轉表格的欄順序，讓第零欄成為最右側的欄，最後一欄則成為最左側的欄。

這不會影響基礎資料中的欄索引，只會影響顯示順序。即使使用這個選項，表格視覺化功能也不支援完整雙向 (BiDi) 語言顯示。如果您啟用分頁 (使用 page 選項)，或因指定的高度和寬度選項小於必要表格大小，導致表格有捲軸，系統會忽略這個選項。預設行為是停用 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.
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` 否則。

回攻員

TableChartBuilder - 這個建構工具適用於鏈結。

`useAlternatingRowStyle(alternate)`

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

預設行為是讓資料列採用交替的顏色樣式。

參數

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

回攻員

TableChartBuilder - 這個建構工具適用於鏈結。

Class TableChartBuilder 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

方法

內容詳盡的說明文件

build()

回攻員

enablePaging(enablePaging)

參數

回攻員

enablePaging(pageSize)

參數

回攻員

enablePaging(pageSize, startPage)

參數

回攻員

enableRtlTable(rtlEnabled)

參數

回攻員

enableSorting(enableSorting)

參數

回攻員

setDataSourceUrl(url)

參數

回攻員

setDataTable(tableBuilder)

參數

回攻員

setDataTable(table)

參數

回攻員

setDataViewDefinition(dataViewDefinition)

參數

回攻員

setDimensions(width, height)

參數

回攻員

setFirstRowNumber(number)

參數

回攻員

setInitialSortingAscending(column)

參數

回攻員

setInitialSortingDescending(column)

參數

回攻員

setOption(option, value)

參數

回攻員

showRowNumberColumn(showRowNumber)

參數

回攻員

useAlternatingRowStyle(alternate)

參數

回攻員

Class TableChartBuilder

`build()`

`enablePaging(enablePaging)`

`enablePaging(pageSize)`

`enablePaging(pageSize, startPage)`

`enableRtlTable(rtlEnabled)`

`enableSorting(enableSorting)`

`setDataSourceUrl(url)`

`setDataTable(tableBuilder)`

`setDataTable(table)`

`setDataViewDefinition(dataViewDefinition)`

`setDimensions(width, height)`

`setFirstRowNumber(number)`

`setInitialSortingAscending(column)`

`setInitialSortingDescending(column)`

`setOption(option, value)`

`showRowNumberColumn(showRowNumber)`

`useAlternatingRowStyle(alternate)`