Class TableChartBuilder

TableChartBuilder

Es un compilador de gráficos de tabla. 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 de una hoja de cálculo de 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étodoTipo de datos que se devuelveDescripción breve
build()ChartCompila el gráfico.
enablePaging(enablePaging)TableChartBuilderEstablece si se debe habilitar la paginación de los datos.
enablePaging(pageSize)TableChartBuilderHabilita la paginación y establece la cantidad 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 comienzan en cero).
enableRtlTable(rtlEnabled)TableChartBuilderAgrega compatibilidad básica para idiomas de derecha a izquierda (como el árabe o el hebreo) invirtiendo el orden de las columnas de la tabla, de modo que la columna cero sea la columna más a la derecha y la última columna sea la columna más a la izquierda.
enableSorting(enableSorting)TableChartBuilderEstablece si se deben ordenar las columnas cuando el usuario hace clic en un encabezado de 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)TableChartBuilderEstablece la tabla de datos que se usará para el gráfico con un DataTableBuilder.
setDataTable(table)TableChartBuilderEstablece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderEstablece la definición de la vista de datos que se usará para el gráfico.
setDimensions(width, height)TableChartBuilderEstablece las dimensiones del gráfico.
setFirstRowNumber(number)TableChartBuilderEstablece el número de fila de la primera fila de la tabla de datos.
setInitialSortingAscending(column)TableChartBuilderEstablece el índice de la columna según la cual se debe ordenar inicialmente la tabla (de forma ascendente).
setInitialSortingDescending(column)TableChartBuilderEstablece el índice de la columna según la cual se debe ordenar inicialmente la tabla (de forma 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 se asigna un estilo de color alternado a las filas pares e impares de un gráfico de tabla.

Documentación detallada

build()

Compila el gráfico.

Volver

Chart: Es un objeto Chart que se puede incorporar en documentos o elementos de la IU, o bien usarse como una imagen estática.


enablePaging(enablePaging)

Establece si se debe habilitar la paginación de los datos.

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

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


enablePaging(pageSize)

Habilita la paginación y establece la cantidad 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.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


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 comienzan en cero).

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

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


enableRtlTable(rtlEnabled)

Agrega compatibilidad básica para idiomas de derecha a izquierda (como el árabe o el hebreo) invirtiendo el orden de las columnas de la tabla, de modo que la columna cero sea la columna más a la derecha y la última columna sea la columna más a la izquierda.

Esto no afecta el índice de la columna en los datos subyacentes, solo el orden de visualización. La visualización de la tabla no admite la visualización completa de idiomas bidireccionales (BiDi) incluso con esta opción. Esta opción se ignora si habilitas la paginación (con la opción page) o si la tabla tiene barras de desplazamiento porque especificaste opciones de altura y ancho más pequeñas 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 el encadenamiento.


enableSorting(enableSorting)

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

Si la clasificación está habilitada, cuando los usuarios hacen clic en el encabezado de la columna, las filas se clasifican automáticamente. El comportamiento predeterminado es la clasificación habilitada.

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


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 un objeto DataTable, se ignora la URL de fuente de datos.

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

Parámetros

NombreTipoDescripción
urlStringEs la URL de la fuente de datos, incluidos los parámetros de consulta.

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setDataTable(tableBuilder)

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

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setDataTable(table)

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

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setDataViewDefinition(dataViewDefinition)

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

Parámetros

NombreTipoDescripción
dataViewDefinitionDataViewDefinitionEs un objeto de definición de vista de datos que define la vista que se debe derivar de la fuente de datos proporcionada para el dibujo del gráfico.

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setDimensions(width, height)

Establece las dimensiones del gráfico.

Parámetros

NombreTipoDescripción
widthIntegerAncho del gráfico en píxeles.
heightIntegerAltura del gráfico en píxeles.

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setFirstRowNumber(number)

Establece el número de fila 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.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setInitialSortingAscending(column)

Establece el índice de la columna según la cual se debe ordenar inicialmente la tabla (de forma ascendente).

La columna está ordenada en orden ascendente y está marcada con una pequeña flecha que lo indica.

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

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


setInitialSortingDescending(column)

Establece el índice de la columna según la cual se debe ordenar inicialmente la tabla (de forma descendente).

La columna está ordenada en orden descendente y está marcada con una pequeña flecha que lo indica.

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

Parámetros

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

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


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 proporcionada no es válida.

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

Parámetros

NombreTipoDescripción
optionStringOpción que se configurará.
valueObjectEs el valor que se establecerá.

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.


showRowNumberColumn(showRowNumber)

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

El comportamiento predeterminado es no mostrar los 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 el encadenamiento.


useAlternatingRowStyle(alternate)

Establece si se asigna un estilo de color alternado a las filas pares e impares de un gráfico de tabla.

El comportamiento predeterminado es que las filas tengan un estilo de color alternado.

Parámetros

NombreTipoDescripción
alternateBooleantrue si los estilos de color deben alternarse; de lo contrario, false.

Volver

TableChartBuilder: Este compilador, útil para el encadenamiento.