Class TableChartBuilder

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啟用分頁功能,設定每頁的列數和要顯示的第一個表格頁面 (第 頁) 以 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。

參數

名稱類型說明
enablePagingBoolean如果應啟用分頁功能,則為 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);

參數

名稱類型說明
pageSizeInteger表格每一頁的列數。

回攻員

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);

參數

名稱類型說明
pageSizeInteger表格每一頁的列數。
startPageInteger要顯示的第一個表格頁面 (頁碼從 0 開始)。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


enableRtlTable(rtlEnabled)

透過將 資料欄順序,因此最右側的資料欄 0 為 0,最後一欄是 最左側的資料欄

這不會影響基礎資料中的欄索引,只會影響顯示的順序。 表格視覺呈現不支援完整雙向 (BiDi) 語言顯示 使用此選項如果您啟用分頁功能 (使用網頁選項),或 表格含有捲軸,因為您指定的高度和寬度選項小於 必要的資料表大小預設行為為停用 RTL 支援功能。

參數

名稱類型說明
rtlEnabledBoolean如果應啟用由右至左支援,請設為 truefalse 反之。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


enableSorting(enableSorting)

設定是否要在使用者點選欄標題時排序資料欄。

如果啟用排序功能,當使用者按一下欄標題時,資料列就會自動 排序預設行為是啟用排序功能。

參數

名稱類型說明
enableSortingBooleantrue 可按一下欄標題啟用排序,否則使用 false 即可。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setDataSourceUrl(url)

設定用來從外部來源 (例如 Google) 擷取資料的資料來源網址 試算表。如有提供資料來源網址和資料表,系統就會忽略資料來源網址。

如要進一步瞭解如何查詢資料來源,請參閱 Google 圖表說明文件

參數

名稱類型說明
urlString資料來源網址,包括任何查詢參數。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setDataTable(tableBuilder)

使用 DataTableBuilder 設定要用於圖表的資料表。這是便利的方法 不必呼叫 build() 就能設定資料表。

參數

名稱類型說明
tableBuilderDataTableBuilder資料表建構工具。系統會立即建立新的資料表 呼叫,因此對建構工具的任何後續更新都不會反映在圖表中。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setDataTable(table)

設定資料表 (其中包含圖表的線條,以及 X 軸標籤)。 第一欄應為字串,並包含橫軸標籤。不限欄數 後方,都必須為數字。每一欄會逐行顯示。

參數

名稱類型說明
tableDataTableSource用於圖表的資料表。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setDataViewDefinition(dataViewDefinition)

設定圖表要使用的資料檢視定義。

參數

名稱類型說明
dataViewDefinitionDataViewDefinition這個資料檢視定義物件用於定義應當的檢視畫面 衍生自圖表繪圖的特定資料來源。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setDimensions(width, height)

設定圖表的維度。

參數

名稱類型說明
widthInteger圖表的寬度,以像素為單位。
heightInteger圖表的高度,以像素為單位。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setFirstRowNumber(number)

設定資料表中第一列的資料列編號。

第一列的預設資料列編號為 1。

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

參數

名稱類型說明
numberInteger資料表中第一列的資料列編號。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setInitialSortingAscending(column)

根據資料表的初始排序設定資料欄索引 (遞增)。

資料欄的 OS 已依遞增順序排序,並顯示一個代表該欄的小箭頭。

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

參數

名稱類型說明
columnInteger資料表應按照初始排序時使用的資料欄數量。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setInitialSortingDescending(column)

根據資料表的初始排序設定資料欄索引 (遞減)。

資料欄 OS 按遞減順序排序,且有一個代表該欄的小箭頭標示。

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

參數

名稱類型說明
columnInteger資料表應按照初始排序時使用的資料欄數量。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


setOption(option, value)

設定這張圖表的進階選項。查看可用的選項: 這份圖表。如果指定的選項無效,此方法就不會有任何作用。

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

參數

名稱類型說明
optionString要設定的選項。
valueObject要設定的值。

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


showRowNumberColumn(showRowNumber)

設定是否顯示資料列編號做為表格的第一欄。

預設行為不會顯示資料列編號。

參數

名稱類型說明
showRowNumberBooleantrue:如果表格的第一欄應顯示資料列編號, 否則為 false

回攻員

TableChartBuilder:這項建構工具適用於鏈結。


useAlternatingRowStyle(alternate)

設定是否要將交替顏色樣式指派給表格圖表中的奇數,甚至是數個列。

預設行為是具有交替顏色樣式的列。

參數

名稱類型說明
alternateBoolean如果顏色樣式應交替處理,則為 true,否則為 false

回攻員

TableChartBuilder:這項建構工具適用於鏈結。