Class DataTableBuilder

資料表格建構工具

DataTable 物件的建構工具。建構資料表時，請先指定資料欄，然後逐一新增資料列。範例：

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

方法

方法傳回類型簡短說明
addColumn(type, label)DataTableBuilder在資料表中新增資料欄。
addRow(values)DataTableBuilder在資料表中新增資料列。
build()DataTable建構並傳回資料表。
setValue(row, column, value)DataTableBuilder在表格中設定特定值。

內容詳盡的說明文件

addColumn(type, label)

在資料表中新增資料欄。系統會新增 0 到 n 個資料欄。

第一欄通常用於圖表標籤 (例如折線圖的 X 軸標籤，或圓餅圖的切片標籤)。其他資料欄通常用於資料，因此通常需要數值。

參數

名稱類型說明
typeColumnType資料欄中的資料類型 (數字、字串或日期)
labelString資料欄的標籤 (用於圖表圖例)。

回攻員

DataTableBuilder：這個建構工具，用於鏈結。

addRow(values)

在資料表中新增資料列。

參數

名稱類型說明
valuesObject[]資料列的值，按照輸入資料欄的順序指定。

回攻員

DataTableBuilder：這個建構工具，用於鏈結。

build()

建構並傳回資料表。

回攻員

DataTable - 資料表

擲回

Error：如果資料表為空白或格式錯誤

setValue(row, column, value)

在表格中設定特定值。

您可以在將資料欄新增至資料表之前設定值。不過，除非在某個時間點新增資料欄，否則系統會忽略該值。

並非所有欄值都需要填入。缺少的項目會視為 null。

參數

名稱類型說明
rowInteger列索引 (第一列的索引為 0)
columnInteger資料欄索引 (第一個資料欄的索引為 0)
valueObject表格儲存格的值 (應為資料欄的正確類型)。

回攻員

DataTableBuilder：這個建構工具，用於鏈結