Class TableChartBuilder

Построитель табличных диаграмм

Конструктор табличных диаграмм. Более подробную информацию можно найти в документации Google Charts .

Вот пример, показывающий, как построить табличную диаграмму. Данные импортируются из электронной таблицы Google .

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Методы

Метод Тип возврата Краткое описание
build() Chart Строит диаграмму.
enable Paging(enablePaging) Table Chart Builder Устанавливает, включать ли постраничное перелистывание данных.
enable Paging(pageSize) Table Chart Builder Включает разбиение по страницам и устанавливает количество строк на каждой странице.
enable Paging(pageSize, startPage) Table Chart Builder Включает разбиение по страницам, устанавливает количество строк на каждой странице и первую отображаемую страницу таблицы (номера страниц начинаются с нуля).
enable Rtl Table(rtlEnabled) Table Chart Builder Добавляет базовую поддержку языков с письмом справа налево (таких как арабский или иврит), изменяя порядок столбцов таблицы на противоположный, так что нулевой столбец является самым правым столбцом, а последний столбец — самым левым столбцом.
enable Sorting(enableSorting) Table Chart Builder Определяет, сортировать ли столбцы, когда пользователь щелкает заголовок столбца.
set Data Source Url(url) Table Chart Builder Устанавливает URL-адрес источника данных, который используется для получения данных из внешнего источника, например Google Таблиц.
set Data Table(tableBuilder) Table Chart Builder Устанавливает таблицу данных, которая будет использоваться для диаграммы, с помощью DataTableBuilder.
set Data Table(table) Table Chart Builder Устанавливает таблицу данных, содержащую линии диаграммы, а также метки оси X.
set Data View Definition(dataViewDefinition) Table Chart Builder Задает определение представления данных, которое будет использоваться для диаграммы.
set Dimensions(width, height) Table Chart Builder Устанавливает размеры диаграммы.
set First Row Number(number) Table Chart Builder Устанавливает номер первой строки в таблице данных.
set Initial Sorting Ascending(column) Table Chart Builder Устанавливает индекс столбца, по которому таблица должна быть изначально отсортирована (по возрастанию).
set Initial Sorting Descending(column) Table Chart Builder Устанавливает индекс столбца, по которому должна быть изначально отсортирована таблица (по убыванию).
set Option(option, value) Table Chart Builder Устанавливает дополнительные параметры для этой диаграммы.
show Row Number Column(showRowNumber) Table Chart Builder Устанавливает, отображать ли номер строки в качестве первого столбца таблицы.
use Alternating Row Style(alternate) Table Chart Builder Определяет, назначается ли чередующийся цветовой стиль нечетным и четным строкам табличной диаграммы.

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

build()

Строит диаграмму.

Возвращаться

Chart — объект Chart, который можно внедрить в документы, элементы пользовательского интерфейса или использовать в качестве статического изображения.


enable Paging(enablePaging)

Устанавливает, включать ли постраничное перелистывание данных.

Поведение по умолчанию — подкачка отключена. Если разбиение по страницам включено, размер страницы по умолчанию равен 10.

Параметры

Имя Тип Описание
enable Paging Boolean true если пейджинг должен быть включен, в противном случае — false .

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


enable Paging(pageSize)

Включает разбиение по страницам и устанавливает количество строк на каждой странице.

Размер страницы по умолчанию — 10.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Параметры

Имя Тип Описание
page Size Integer Количество строк на каждой странице таблицы.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


enable Paging(pageSize, startPage)

Включает разбиение по страницам, устанавливает количество строк на каждой странице и первую отображаемую страницу таблицы (номера страниц начинаются с нуля).

Размер страницы по умолчанию — 10, а стартовая страница по умолчанию — 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Параметры

Имя Тип Описание
page Size Integer Количество строк на каждой странице таблицы.
start Page Integer Первая отображаемая страница таблицы (номера страниц начинаются с нуля).

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


enable Rtl Table(rtlEnabled)

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

Это не влияет на индекс столбца в базовых данных, а только на порядок отображения. Полное двунаправленное языковое отображение (BiDi) не поддерживается визуализацией таблицы даже при использовании этой опции. Этот параметр игнорируется, если вы включаете разбивку по страницам (используя параметр страницы) или если в таблице есть полосы прокрутки, поскольку вы указали параметры высоты и ширины, меньшие, чем требуемый размер таблицы. По умолчанию поддержка RTL отключена.

Параметры

Имя Тип Описание
rtl Enabled Boolean true , если должна быть включена поддержка направления справа налево, в противном случае false .

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


enable Sorting(enableSorting)

Определяет, сортировать ли столбцы, когда пользователь щелкает заголовок столбца.

Если сортировка включена, когда пользователи нажимают на заголовок столбца, строки сортируются автоматически. По умолчанию сортировка включена.

Параметры

Имя Тип Описание
enable Sorting Boolean true , чтобы включить сортировку по щелчку заголовков столбцов, в противном случае false .

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Data Source Url(url)

Устанавливает URL-адрес источника данных, который используется для получения данных из внешнего источника, например Google Таблиц. Если указаны URL-адрес источника данных и DataTable, URL-адрес источника данных игнорируется.

Дополнительную информацию о запросах к источникам данных см. в документации Google Charts .

Параметры

Имя Тип Описание
url String URL-адрес источника данных, включая все параметры запроса.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Data Table(tableBuilder)

Задает таблицу данных, которая будет использоваться для диаграммы, с помощью DataTableBuilder. Это удобный метод настройки таблицы данных без необходимости вызова build() .

Параметры

Имя Тип Описание
table Builder Data Table Builder Построитель таблиц данных. Новая таблица данных создается мгновенно в рамках этого вызова, поэтому любые дальнейшие обновления построителя не будут отражены на диаграмме.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Data Table(table)

Устанавливает таблицу данных, содержащую линии диаграммы, а также метки оси X. Первый столбец должен представлять собой строку и содержать метки по горизонтальной оси. Следовать может любое количество столбцов, все они должны быть числовыми. Каждый столбец отображается как отдельная строка.

Параметры

Имя Тип Описание
table Data Table Source Таблица данных, которая будет использоваться для диаграммы.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Data View Definition(dataViewDefinition)

Задает определение представления данных, которое будет использоваться для диаграммы.

Параметры

Имя Тип Описание
data View Definition Data View Definition Объект определения представления данных, определяющий представление, которое должно быть получено из данного источника данных для рисунка диаграммы.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Dimensions(width, height)

Устанавливает размеры диаграммы.

Параметры

Имя Тип Описание
width Integer Ширина диаграммы в пикселях.
height Integer Высота диаграммы в пикселях.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set First Row Number(number)

Устанавливает номер первой строки в таблице данных.

Номер строки по умолчанию для первой строки равен 1.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Параметры

Имя Тип Описание
number Integer Номер строки для первой строки в таблице данных.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Initial Sorting Ascending(column)

Устанавливает индекс столбца, по которому таблица должна быть изначально отсортирована (по возрастанию).

Столбец отсортирован по возрастанию и отмечен маленькой стрелкой, указывающей на это.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Параметры

Имя Тип Описание
column Integer Номер столбца, по которому должна быть изначально отсортирована таблица.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Initial Sorting Descending(column)

Устанавливает индекс столбца, по которому должна быть изначально отсортирована таблица (по убыванию).

Столбец отсортирован по убыванию и отмечен маленькой стрелкой, указывающей на это.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Параметры

Имя Тип Описание
column Integer Номер столбца, по которому должна быть изначально отсортирована таблица.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


set Option(option, value)

Устанавливает дополнительные параметры для этой диаграммы. См . доступные параметры для этой диаграммы . Этот метод не имеет эффекта, если данная опция недействительна.

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Параметры

Имя Тип Описание
option String Возможность установки.
value Object Значение, которое необходимо установить.

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


show Row Number Column(showRowNumber)

Устанавливает, отображать ли номер строки в качестве первого столбца таблицы.

Поведение по умолчанию не показывает номера строк.

Параметры

Имя Тип Описание
show Row Number Boolean true , если в первом столбце таблицы должен отображаться номер строки, в противном случае false .

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.


use Alternating Row Style(alternate)

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

Поведение по умолчанию — строки имеют чередующийся цветовой стиль.

Параметры

Имя Тип Описание
alternate Boolean true , если цветовые стили должны чередоваться, в противном случае — false .

Возвращаться

Table Chart Builder — этот построитель полезен для создания цепочек.