Um builder para gráficos de tabela. Para mais detalhes, consulte a documentação do Gráficos Google.
Confira um exemplo de como criar um gráfico de tabela. Os dados são importados de uma planilha 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();
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
build() | Chart | Cria o gráfico. |
enable | Table | Define se a paginação dos dados será ativada. |
enable | Table | Ativa a paginação e define o número de linhas em cada página. |
enable | Table | Ativa a paginação, define o número de linhas em cada página e a primeira página da tabela a ser exibida (os números das páginas são baseados em zero). |
enable | Table | Adiciona suporte básico para idiomas da direita para a esquerda (como árabe ou hebraico) invertendo a ordem das colunas da tabela. Assim, a coluna zero é a mais à direita, e a última coluna é a mais à esquerda. |
enable | Table | Define se as colunas serão classificadas quando o usuário clicar em um cabeçalho de coluna. |
set | Table | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Table | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Table | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Table | Define a definição da visualização de dados a ser usada no gráfico. |
set | Table | Define as dimensões do gráfico. |
set | Table | Define o número da primeira linha na tabela de dados. |
set | Table | Define o índice da coluna de acordo com a qual a tabela deve ser classificada inicialmente (em ordem crescente). |
set | Table | Define o índice da coluna de acordo com a qual a tabela deve ser classificada inicialmente (em ordem decrescente). |
set | Table | Define opções avançadas para este gráfico. |
show | Table | Define se o número da linha vai aparecer como a primeira coluna da tabela. |
use | Table | Define se o estilo de cores alternadas é atribuído a linhas pares e ímpares de um gráfico de tabela. |
Documentação detalhada
build()
Cria o gráfico.
Retornar
Chart: um objeto de gráfico que pode ser incorporado a documentos, elementos da interface ou usado como uma imagem estática.
enablePaging(enablePaging)
Define se a paginação dos dados será ativada.
O comportamento padrão é a paginação desativada. Se a paginação estiver ativada, o tamanho de página padrão será 10.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
enable | Boolean | true se a paginação estiver ativada, false caso contrário. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
enablePaging(pageSize)
Ativa a paginação e define o número de linhas em cada página.
O tamanho de página padrão é 10.
// Creates a table chart builder and enables paging with page size of 5. const builder = Charts.newTableChart(); builder.enablePaging(5);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
page | Integer | O número de linhas em cada página da tabela. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
enablePaging(pageSize, startPage)
Ativa a paginação, define o número de linhas em cada página e a primeira página da tabela a ser exibida (os números das páginas são baseados em zero).
O tamanho de página padrão é 10, e a página inicial padrão é 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);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
page | Integer | O número de linhas em cada página da tabela. |
start | Integer | A primeira página da tabela a ser mostrada. Os números das páginas são baseados em zero. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
enableRtlTable(rtlEnabled)
Adiciona suporte básico para idiomas da direita para a esquerda (como árabe ou hebraico) invertendo a ordem das colunas da tabela. Assim, a coluna zero é a mais à direita, e a última coluna é a mais à esquerda.
Isso não afeta o índice da coluna nos dados subjacentes, apenas a ordem de exibição. A visualização de tabela não é compatível com a exibição completa de idiomas bidirecionais (BiDi), mesmo com essa opção. Essa opção é ignorada se você ativar a paginação (usando a opção "Página") ou se a tabela tiver barras de rolagem porque você especificou opções de altura e largura menores que o tamanho necessário da tabela. O comportamento padrão é o suporte a RTL desativado.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
rtl | Boolean | true se o suporte da direita para a esquerda precisar ser ativado. Caso contrário, false. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
enableSorting(enableSorting)
Define se as colunas serão classificadas quando o usuário clicar em um cabeçalho de coluna.
Se a classificação estiver ativada, quando os usuários clicarem no cabeçalho da coluna, as linhas serão classificadas automaticamente. O comportamento padrão é a classificação ativada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
enable | Boolean | true para ativar a classificação clicando nos cabeçalhos das colunas ou false caso contrário. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setDataSourceUrl(url)
Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. Se um URL de fonte de dados e uma DataTable forem fornecidos, o URL de fonte de dados será ignorado.
Para mais informações sobre como consultar fontes de dados, consulte a documentação do Gráficos Google.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
url | String | O URL da fonte de dados, incluindo parâmetros de consulta. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setDataTable(tableBuilder)
Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. Esse é um método conveniente
para definir a tabela de dados sem precisar chamar build().
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
table | Data | Um criador de tabelas de dados. Uma nova tabela de dados é criada instantaneamente como parte dessa chamada. Portanto, outras atualizações no builder não serão refletidas no gráfico. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setDataTable(table)
Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A primeira coluna precisa ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas pode seguir, e todas precisam ser numéricas. Cada coluna é mostrada como uma linha separada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
table | Data | A tabela de dados a ser usada no gráfico. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setDataViewDefinition(dataViewDefinition)
Define a definição da visualização de dados a ser usada no gráfico.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
data | Data | Um objeto de definição de visualização de dados que define a visualização a ser derivada da fonte de dados especificada para o desenho do gráfico. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setDimensions(width, height)
Define as dimensões do gráfico.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
width | Integer | A largura do gráfico, em pixels. |
height | Integer | A altura do gráfico, em pixels. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setFirstRowNumber(number)
Define o número da primeira linha na tabela de dados.
O número padrão da primeira linha é 1.
// Creates a table chart builder and sets the first row to be 2. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
number | Integer | O número da primeira linha na tabela de dados. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setInitialSortingAscending(column)
Define o índice da coluna de acordo com a qual a tabela deve ser classificada inicialmente (em ordem crescente).
A coluna é classificada em ordem crescente e marcada com uma pequena seta indicando isso.
// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
column | Integer | O número da coluna de acordo com a qual a tabela deve ser classificada inicialmente. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setInitialSortingDescending(column)
Define o índice da coluna de acordo com a qual a tabela deve ser classificada inicialmente (em ordem decrescente).
A coluna é classificada em ordem decrescente e marcada com uma pequena seta indicando isso.
// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
column | Integer | O número da coluna de acordo com a qual a tabela deve ser classificada inicialmente. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
setOption(option, value)
Define opções avançadas para este gráfico. Confira as opções disponíveis para esse gráfico. Esse método não terá efeito se a opção fornecida for inválida.
// Build a table chart which renders HTML. const builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); const chart = builder.build();
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
option | String | A opção a ser definida. |
value | Object | O valor que será definido. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
showRowNumberColumn(showRowNumber)
Define se o número da linha vai aparecer como a primeira coluna da tabela.
O comportamento padrão é não mostrar os números das linhas.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
show | Boolean | true se a primeira coluna da tabela mostrar o número da linha ou false caso contrário. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.
useAlternatingRowStyle(alternate)
Define se o estilo de cores alternadas é atribuído a linhas pares e ímpares de um gráfico de tabela.
O comportamento padrão é que as linhas tenham um estilo de cor alternada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
alternate | Boolean | true se os estilos de cores precisarem ser alternados. Caso contrário, false. |
Retornar
TableChartBuilder: esse builder, útil para encadeamento.