Class DataTableBuilder

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 軸標籤，或是圓餅圖的切片標籤)。其他資料欄通常用於資料，因此通常需要數值。

參數

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

回攻員

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

---

addRow(values)

在資料表中新增資料列。

參數

名稱	類型	說明
values	Object[]	資料列的值，順序與輸入資料欄的順序相同。

回攻員

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

---

build()

建構並傳回資料表。

回攻員

DataTable - 資料表

擲回

Error：資料表空白或格式錯誤時

---

setValue(row, column, value)

在表格中設定特定值。

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

並非所有欄位值都必須填寫。如果缺少這些值，系統會視為 null。

參數

名稱	類型	說明
row	Integer	列索引 (第一列的索引為 0)
column	Integer	欄索引 (第一欄的索引為 0)
value	Object	表格儲存格的值 (應具有資料欄的正確類型)。

回攻員

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