Class TableChartBuilder

TableChartBuilder

Un compilador para gráficos de tablas Para obtener más detalles, consulta la documentación de Google Charts.

Este es un ejemplo que muestra cómo crear un gráfico de tabla. Los datos se importan desde una hoja de cálculo de 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();

Métodos

MétodoTipo de datos que se muestraDescripción breve
build()ChartCompila el gráfico.
enablePaging(enablePaging)TableChartBuilderEstablece si se debe habilitar la paginación a través de los datos.
enablePaging(pageSize)TableChartBuilderHabilita la paginación y establece el número de filas en cada página.
enablePaging(pageSize, startPage)TableChartBuilderHabilita la paginación, establece la cantidad de filas en cada página y la primera página de la tabla que se mostrará (los números de página se basan en cero).
enableRtlTable(rtlEnabled)TableChartBuilderAgrega compatibilidad básica para idiomas con escritura de derecha a izquierda (como árabe o hebreo) mediante la reversión del orden de las columnas de la tabla, de modo que la columna cero es la columna más a la derecha y la última columna es la más a la izquierda.
enableSorting(enableSorting)TableChartBuilderEstablece si se deben ordenar las columnas cuando el usuario hace clic en el encabezado de una columna.
setDataSourceUrl(url)TableChartBuilderEstablece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google.
setDataTable(tableBuilder)TableChartBuilderConfigura la tabla de datos que se usará para el gráfico con DataTableBuilder.
setDataTable(table)TableChartBuilderEstablece la tabla de datos que contiene las líneas del gráfico y las etiquetas del eje X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderEstablece la definición de la vista de datos para usar en el gráfico.
setDimensions(width, height)TableChartBuilderEstablece las dimensiones del gráfico.
setFirstRowNumber(number)TableChartBuilderEstablece el número de la primera fila de la tabla de datos.
setInitialSortingAscending(column)TableChartBuilderEstablece el índice de la columna según el que la tabla debería ordenarse de forma inicial (ascendente).
setInitialSortingDescending(column)TableChartBuilderEstablece el índice de la columna según el que la tabla debería ordenarse de forma inicial (descendente).
setOption(option, value)TableChartBuilderEstablece opciones avanzadas para este gráfico.
showRowNumberColumn(showRowNumber)TableChartBuilderEstablece si se debe mostrar el número de fila como la primera columna de la tabla.
useAlternatingRowStyle(alternate)TableChartBuilderEstablece si el estilo de color alternativo se asigna a filas impares y pares de un gráfico de tabla.

Documentación detallada

build()

Compila el gráfico.

Volver

Chart: Es un objeto de gráfico que se puede incorporar en documentos, elementos de la IU o usar como imagen estática.


enablePaging(enablePaging)

Establece si se debe habilitar la paginación a través de los datos.

El comportamiento predeterminado es la paginación inhabilitada. Si la paginación está habilitada, el tamaño predeterminado de la página es 10.

Parámetros

NombreTipoDescripción
enablePagingBooleantrue si se debe habilitar la paginación, de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


enablePaging(pageSize)

Habilita la paginación y establece el número de filas en cada página.

El tamaño de página predeterminado es 10.

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

Parámetros

NombreTipoDescripción
pageSizeIntegerLa cantidad de filas en cada página de la tabla.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


enablePaging(pageSize, startPage)

Habilita la paginación, establece la cantidad de filas en cada página y la primera página de la tabla que se mostrará (los números de página se basan en cero).

El tamaño predeterminado de la página es 10 y el tamaño predeterminado es 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);

Parámetros

NombreTipoDescripción
pageSizeIntegerLa cantidad de filas en cada página de la tabla.
startPageIntegerLa primera página de la tabla que se mostrará (los números de página se basan en cero).

Volver

TableChartBuilder: Este compilador, útil para encadenar.


enableRtlTable(rtlEnabled)

Agrega compatibilidad básica para idiomas con escritura de derecha a izquierda (como árabe o hebreo) mediante la reversión del orden de las columnas de la tabla, de modo que la columna cero es la columna más a la derecha y la última columna es la más a la izquierda.

Esto no afecta el índice de columna en los datos subyacentes, solo el orden en el que se muestra. La visualización de tablas bidireccionales no es compatible con la visualización bidireccional total de la tabla, incluso con esta opción. Esta opción se ignora si habilitas la paginación (con la opción de página) o si la tabla tiene barras de desplazamiento porque especificaste opciones de altura y ancho menores que el tamaño de tabla requerido. El comportamiento predeterminado es la compatibilidad con RTL inhabilitada.

Parámetros

NombreTipoDescripción
rtlEnabledBooleantrue si se debe habilitar la compatibilidad de derecha a izquierda; de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


enableSorting(enableSorting)

Establece si se deben ordenar las columnas cuando el usuario hace clic en el encabezado de una columna.

Si el ordenamiento está habilitado, cuando los usuarios hacen clic en el encabezado de la columna, las filas se ordenan automáticamente. El comportamiento predeterminado es el ordenamiento habilitado.

Parámetros

NombreTipoDescripción
enableSortingBooleantrue para habilitar el ordenamiento haciendo clic en los encabezados de las columnas; de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setDataSourceUrl(url)

Establece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google. Si se proporcionan una URL de fuente de datos y una tabla de datos, se ignora la URL de fuente de datos.

Para obtener más información sobre cómo consultar fuentes de datos, revisa la documentación de Google Charts.

Parámetros

NombreTipoDescripción
urlStringLa URL de la fuente de datos, incluidos los parámetros de búsqueda.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setDataTable(tableBuilder)

Configura la tabla de datos que se usará para el gráfico con DataTableBuilder. Este es un método conveniente para configurar la tabla de datos sin necesidad de llamar a build().

Parámetros

NombreTipoDescripción
tableBuilderDataTableBuilderUn compilador de tablas de datos Como parte de esta llamada, se crea una tabla de datos nueva de forma instantánea, por lo que las actualizaciones posteriores al compilador no se reflejarán en el gráfico.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setDataTable(table)

Establece la tabla de datos que contiene las líneas del gráfico y las etiquetas del eje X. La primera columna debe ser una string y contener las etiquetas del eje horizontal. Cualquier cantidad de columnas puede seguir, todas deben ser numéricas. Cada columna se muestra como una línea separada.

Parámetros

NombreTipoDescripción
tableDataTableSourceLa tabla de datos que se usará para el gráfico.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setDataViewDefinition(dataViewDefinition)

Establece la definición de la vista de datos para usar en el gráfico.

Parámetros

NombreTipoDescripción
dataViewDefinitionDataViewDefinitionUn objeto de definición de vista de datos que define la vista que debe derivar de la fuente de datos determinada para el dibujo del gráfico.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setDimensions(width, height)

Establece las dimensiones del gráfico.

Parámetros

NombreTipoDescripción
widthIntegerEs el ancho del gráfico en píxeles.
heightIntegerLa altura del gráfico en píxeles.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setFirstRowNumber(number)

Establece el número de la primera fila de la tabla de datos.

El número de fila predeterminado de la primera fila es 1.

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

Parámetros

NombreTipoDescripción
numberIntegerNúmero de fila de la primera fila de la tabla de datos.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setInitialSortingAscending(column)

Establece el índice de la columna según el que la tabla debería ordenarse de forma inicial (ascendente).

La columna "SO" está ordenada de forma ascendente y está marcada con una flecha pequeña que indica eso.

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

Parámetros

NombreTipoDescripción
columnIntegerNúmero de la columna según la cual se debe ordenar inicialmente la tabla.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setInitialSortingDescending(column)

Establece el índice de la columna según el que la tabla debería ordenarse de forma inicial (descendente).

La columna "SO" está ordenada de forma descendente y está marcada con una flecha pequeña que indica eso.

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

Parámetros

NombreTipoDescripción
columnIntegerNúmero de la columna según la cual se debe ordenar inicialmente la tabla.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


setOption(option, value)

Establece opciones avanzadas para este gráfico. Consulta las opciones disponibles para este gráfico. Este método no tiene efecto si la opción especificada no es válida.

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

Parámetros

NombreTipoDescripción
optionStringLa opción de establecer.
valueObjectValor que se va a establecer

Volver

TableChartBuilder: Este compilador, útil para encadenar.


showRowNumberColumn(showRowNumber)

Establece si se debe mostrar el número de fila como la primera columna de la tabla.

El comportamiento predeterminado no muestra números de fila.

Parámetros

NombreTipoDescripción
showRowNumberBooleantrue si la primera columna de la tabla debe mostrar el número de fila, de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para encadenar.


useAlternatingRowStyle(alternate)

Establece si el estilo de color alternativo se asigna a filas impares y pares de un gráfico de tabla.

El comportamiento predeterminado es el de las filas que tienen un estilo de color alternativo.

Parámetros

NombreTipoDescripción
alternateBooleantrue si los estilos de color deberían ser alternativos; de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para encadenar.