Class TableChartBuilder

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, который можно встраивать в документы, элементы пользовательского интерфейса или использовать в качестве статического изображения.

enablePaging(enablePaging)

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

enablePaging(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 Количество строк на каждой странице таблицы.

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

enablePaging(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 Первая отображаемая страница таблицы (нумерация страниц начинается с нуля).

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

enableRtlTable(rtlEnabled)

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

enableSorting(enableSorting)

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setDataSourceUrl(url)

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setDataTable(tableBuilder)

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setDataTable(table)

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setDataViewDefinition(dataViewDefinition)

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

Параметры

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

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

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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setInitialSortingAscending(column)

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

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setInitialSortingDescending(column)

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

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

setOption(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 Значение, которое нужно установить.

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

showRowNumberColumn(showRowNumber)

Определяет, следует ли отображать номер строки в первом столбце таблицы.

По умолчанию номера строк не отображаются.

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.

useAlternatingRowStyle(alternate)

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

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

Параметры

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

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

TableChartBuilder — этот конструктор полезен для создания цепочек диаграмм.