Class TableChartBuilder

TableChartBuilder

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

A continuación, te mostramos un ejemplo de 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()ChartCrea 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 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 se basan en cero).
enableRtlTable(rtlEnabled)TableChartBuilderAgrega compatibilidad básica con idiomas que se escriben 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 que se encuentra en el extremo derecho y la última, la que se encuentra 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)TableChartBuilderConfigura 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 mediante 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 vista de datos que se usará para el gráfico.
setDimensions(width, height)TableChartBuilderEstablece las dimensiones para el gráfico.
setFirstRowNumber(number)TableChartBuilderEstablece el número de fila de la primera fila en la tabla de datos.
setInitialSortingAscending(column)TableChartBuilderEstablece el índice de la columna según el cual la tabla debe ordenarse inicialmente (orden ascendente).
setInitialSortingDescending(column)TableChartBuilderEstablece el índice de la columna según el cual la tabla debe ordenarse inicialmente (orden descendente).
setOption(option, value)TableChartBuilderEstablece las opciones avanzadas para este gráfico.
showRowNumberColumn(showRowNumber)TableChartBuilderEstablece si se muestra el número de fila como la primera columna de la tabla.
useAlternatingRowStyle(alternate)TableChartBuilderEstablece si el estilo de color alternativo se asigna a las filas impares y pares de un gráfico de tabla.

Documentación detallada

build()

Crea el gráfico.

Devolvedor

Chart: Es un objeto de gráfico que se puede incorporar en documentos y elementos de la IU, o que se puede 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
enablePagingBooleanEs true si se debe habilitar la paginación, de lo contrario, false.

Devolvedor

TableChartBuilder: Este compilador es ú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.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es ú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 se basan en cero).

El tamaño predeterminado de la página es 10 y el tamaño predeterminado de la página de inicio 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.
startPageIntegerEs la primera página de la tabla que se mostrará (los números de página se basan en cero).

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


enableRtlTable(rtlEnabled)

Agrega compatibilidad básica con idiomas que se escriben 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 que se encuentra en el extremo derecho y la última, la que se encuentra 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 idiomas totalmente bidireccional (BiDi) no es compatible con la visualización de tablas, 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 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.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


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.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setDataSourceUrl(url)

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

Si deseas obtener más información para consultar fuentes de datos, lee la documentación de Gráficos de Google.

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setDataTable(tableBuilder)

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

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es ú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 string y contener las etiquetas del eje horizontal. Cualquier cantidad de columnas puede estar seguida, 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.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setDataViewDefinition(dataViewDefinition)

Establece la definición de 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 determinada para el dibujo del gráfico.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setDimensions(width, height)

Establece las dimensiones para el gráfico.

Parámetros

NombreTipoDescripción
widthIntegerIndica el ancho del gráfico en píxeles.
heightIntegerIndica la altura del gráfico en píxeles.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setFirstRowNumber(number)

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

El número 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
numberIntegerEl número de la primera fila de la tabla de datos.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setInitialSortingAscending(column)

Establece el índice de la columna según el cual la tabla debe ordenarse inicialmente (orden ascendente).

El SO de la columna está ordenado de forma ascendente y está marcado con una flecha pequeña que lo indica.

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

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setInitialSortingDescending(column)

Establece el índice de la columna según el cual la tabla debe ordenarse inicialmente (orden descendente).

El SO de la columna se ordena de forma descendente y está marcado con una flecha pequeña que lo indica.

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

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


setOption(option, value)

Establece las 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.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

Parámetros

NombreTipoDescripción
optionStringLa opción de configurar.
valueObjectEl valor que se establecerá.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


showRowNumberColumn(showRowNumber)

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

El comportamiento predeterminado es que no se muestren los números de las filas.

Parámetros

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

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.


useAlternatingRowStyle(alternate)

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

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

Parámetros

NombreTipoDescripción
alternateBooleantrue si los estilos de color deben ser alternados, false de lo contrario.

Devolvedor

TableChartBuilder: Este compilador es útil para el encadenamiento.