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();

Методы

Метод Тип возвращаемого значения Краткое описание
add Column(type, label) Data Table Builder Добавляет столбец в таблицу данных.
add Row(values) Data Table Builder Добавляет строку в таблицу данных.
build() Data Table Создаёт и возвращает таблицу данных.
set Value(row, column, value) Data Table Builder Задает определенное значение в таблице.

Подробная документация

addColumn(type, label)

Добавляет столбец в таблицу данных. Столбцы будут добавляться от 0 до n.

Первый столбец часто используется диаграммами для подписей (например, подписи оси X на линейных диаграммах или подписи секторов на круговых диаграммах). Остальные столбцы часто используются для данных и, следовательно, часто требуют числовых значений.

Параметры

Имя Тип Описание
type Column Type Тип данных в столбце (число, строка или дата)
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 — этот конструктор предназначен для создания цепочек таблиц.