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