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 - 此构建器，用于链式调用