Эта страница переведена с помощью Cloud Translation API.

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 — этот построитель, полезный для создания цепочек.