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

---

addRow(values)

向数据表中添加一行。

参数

名称	类型	说明
values	Object[]	行对应的值，按照输入列的顺序指定。

返回

DataTableBuilder - this 构建器，用于链式调用。

---

build()

构建并返回数据表格。

返回

DataTable - 数据表格

抛出

Error - 如果数据表为空或格式有误

---

setValue(row, column, value)

在表中设置特定值。

您可以在将列添加到数据表之前设置值。不过，除非您在某个时间点添加该列，否则系统会忽略该值。

并非所有列值都需要填写。缺失的值将被视为 null。

参数

名称	类型	说明
row	Integer	行索引（第一行索引为 0）
column	Integer	列索引（第一列的索引为 0）
value	Object	表格单元格的值（应为该列的正确类型）。

返回

DataTableBuilder - this 构建器，用于链式调用