Построитель объектов 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 на линейных диаграммах или меток срезов на круговых диаграммах). Остальные столбцы часто используются для данных и поэтому часто требуют числовых значений.
Параметры
Имя | Тип | Описание |
---|---|---|
type | ColumnType | тип данных в столбце (число, строка или дата) |
label | String | метка столбца (используется для легенд диаграмм). |
Возвращаться
DataTableBuilder
— это конструктор для создания цепочек.
addRow(values)
Добавляет строку в таблицу данных.
Параметры
Имя | Тип | Описание |
---|---|---|
values | Object[] | значения для строки, указанные в том же порядке, в котором вводятся столбцы. |
Возвращаться
DataTableBuilder
— это конструктор для создания цепочек.
build()
setValue(row, column, value)
Устанавливает определенное значение в таблице.
Вы можете установить значение перед добавлением столбца в таблицу данных. Однако, если столбец не будет добавлен в какой-то момент, значение будет игнорироваться.
Не все значения столбцов необходимо заполнять. Отсутствующие значения будут считаться null
.
Параметры
Имя | Тип | Описание |
---|---|---|
row | Integer | индекс строки (первая строка имеет индекс 0) |
column | Integer | индекс столбца (первый столбец имеет индекс 0) |
value | Object | значение ячейки таблицы (должно иметь правильный тип для столбца). |
Возвращаться
DataTableBuilder
— этот конструктор для создания цепочек