Class TableChartBuilder

ТаблицаДиаграммаСтроитель

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

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

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

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

var chart = chartBuilder.build();

Методы

Метод Тип возврата Краткое описание
build() Chart Строит диаграмму.
enablePaging(enablePaging) TableChartBuilder Устанавливает, включать ли постраничное перелистывание данных.
enablePaging(pageSize) TableChartBuilder Включает разбиение по страницам и устанавливает количество строк на каждой странице.
enablePaging(pageSize, startPage) TableChartBuilder Включает разбиение по страницам, устанавливает количество строк на каждой странице и первую отображаемую страницу таблицы (номера страниц начинаются с нуля).
enableRtlTable(rtlEnabled) TableChartBuilder Добавляет базовую поддержку языков с письмом справа налево (таких как арабский или иврит), изменяя порядок столбцов таблицы на обратный, так что нулевой столбец является самым правым столбцом, а последний столбец — самым левым столбцом.
enableSorting(enableSorting) TableChartBuilder Определяет, сортировать ли столбцы, когда пользователь щелкает заголовок столбца.
setDataSourceUrl(url) TableChartBuilder Устанавливает URL-адрес источника данных, который используется для получения данных из внешнего источника, например Google Таблиц.
setDataTable(tableBuilder) TableChartBuilder Устанавливает таблицу данных, которая будет использоваться для диаграммы, с помощью DataTableBuilder.
setDataTable(table) TableChartBuilder Устанавливает таблицу данных, содержащую линии диаграммы, а также метки оси X.
setDataViewDefinition(dataViewDefinition) TableChartBuilder Задает определение представления данных, которое будет использоваться для диаграммы.
setDimensions(width, height) TableChartBuilder Устанавливает размеры диаграммы.
setFirstRowNumber(number) TableChartBuilder Устанавливает номер первой строки в таблице данных.
setInitialSortingAscending(column) TableChartBuilder Устанавливает индекс столбца, по которому таблица должна быть изначально отсортирована (по возрастанию).
setInitialSortingDescending(column) TableChartBuilder Устанавливает индекс столбца, по которому должна быть изначально отсортирована таблица (по убыванию).
setOption(option, value) TableChartBuilder Устанавливает дополнительные параметры для этой диаграммы.
showRowNumberColumn(showRowNumber) TableChartBuilder Устанавливает, отображать ли номер строки в качестве первого столбца таблицы.
useAlternatingRowStyle(alternate) TableChartBuilder Определяет, назначается ли чередующийся цветовой стиль нечетным и четным строкам табличной диаграммы.

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

build()

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

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

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


enablePaging(enablePaging)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


enablePaging(pageSize)

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

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


enablePaging(pageSize, startPage)

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

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


enableRtlTable(rtlEnabled)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


enableSorting(enableSorting)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setDataSourceUrl(url)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setDataTable(tableBuilder)

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setDataTable(table)

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setDataViewDefinition(dataViewDefinition)

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setDimensions(width, height)

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setFirstRowNumber(number)

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

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setInitialSortingAscending(column)

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

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setInitialSortingDescending(column)

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

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


setOption(option, value)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


showRowNumberColumn(showRowNumber)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.


useAlternatingRowStyle(alternate)

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

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

Параметры

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

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

TableChartBuilder — этот построитель, полезный для создания цепочек.