Class DataTableBuilder

DataTableBuilder

DataTable 对象的构建器。构建数据表的方法如下:首先指定其列,然后逐一添加其行。例如:

var 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 - 此构建器,用于链接