Se usó la API de Cloud Translation para traducir esta página.

Class TableChartBuilder

Es un compilador de gráficos de tablas. Para obtener más detalles, consulta la documentación de Gráficos de Google.

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.
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 datos que se muestra	Descripción breve
`build()`	`Chart`	Compila el gráfico.
`enablePaging(enablePaging)`	`TableChartBuilder`	Establece si se debe habilitar la paginación a través de los datos.
`enablePaging(pageSize)`	`TableChartBuilder`	Habilita la paginación y establece la cantidad de filas en cada página.
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	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).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	Agrega compatibilidad básica con 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 más a la derecha y la última columna sea la más a la izquierda.
`enableSorting(enableSorting)`	`TableChartBuilder`	Establece si se ordenan las columnas cuando el usuario hace clic en el encabezado de una columna.
`setDataSourceUrl(url)`	`TableChartBuilder`	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.
`setDataTable(tableBuilder)`	`TableChartBuilder`	Establece la tabla de datos que se usará para el gráfico con un DataTableBuilder.
`setDataTable(table)`	`TableChartBuilder`	Establece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X.
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	Establece la definición de vista de datos que se usará para el gráfico.
`setDimensions(width, height)`	`TableChartBuilder`	Establece las dimensiones del gráfico.
`setFirstRowNumber(number)`	`TableChartBuilder`	Establece el número de fila para la primera fila de la tabla de datos.
`setInitialSortingAscending(column)`	`TableChartBuilder`	Establece el índice de la columna según el cual se debe ordenar inicialmente la tabla (ascendente).
`setInitialSortingDescending(column)`	`TableChartBuilder`	Establece el índice de la columna según el cual se debe ordenar inicialmente la tabla (descendente).
`setOption(option, value)`	`TableChartBuilder`	Establece opciones avanzadas para este gráfico.
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	Establece si se mostrará el número de fila como la primera columna de la tabla.
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	Establece si se asigna un estilo de color alternativo a las filas impares y pares 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, 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 que la paginación esté inhabilitada. Si está habilitada la paginación, el tamaño de página predeterminado es 10.

Parámetros

Nombre	Tipo	Descripción
`enablePaging`	`Boolean`	`true` si se debe habilitar la paginación, `false` de lo contrario.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`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

Nombre	Tipo	Descripción
`pageSize`	`Integer`	Es la cantidad de filas en cada página de la tabla.

Volver

TableChartBuilder: Este compilador es ú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 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

Nombre	Tipo	Descripción
`pageSize`	`Integer`	Es la cantidad de filas en cada página de la tabla.
`startPage`	`Integer`	Es la primera página de la tabla que se muestra (los números de página se basan en cero).

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`enableRtlTable(rtlEnabled)`

Agrega compatibilidad básica con 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 más a la derecha y la última columna sea la más a la izquierda.

Esto no afecta el índice de columna en los datos subyacentes, solo el orden de visualización. La visualización de idiomas bidireccionales (BiDi) completa 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 requerido de la tabla. El comportamiento predeterminado es inhabilitar la compatibilidad con RTL.

Parámetros

Nombre	Tipo	Descripción
`rtlEnabled`	`Boolean`	`true` si se debe habilitar la compatibilidad de derecha a izquierda, `false` de lo contrario.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`enableSorting(enableSorting)`

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

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

Parámetros

Nombre	Tipo	Descripción
`enableSorting`	`Boolean`	`true` para habilitar el ordenamiento haciendo clic en los encabezados de las columnas, `false` de lo contrario.

Volver

TableChartBuilder: Este compilador es ú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 un 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 Gráficos de Google.

Parámetros

Nombre	Tipo	Descripción
`url`	`String`	La URL de la fuente de datos, incluidos los parámetros de consulta

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`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

Nombre	Tipo	Descripción
`tableBuilder`	`DataTableBuilder`	Un creador de tablas de datos. Se crea una tabla de datos nueva de inmediato como parte de esta llamada, por lo que las actualizaciones adicionales del compilador no se reflejarán en el gráfico.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`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. Se puede agregar cualquier cantidad de columnas, todas deben ser numéricas. Cada columna se muestra como una línea independiente.

Parámetros

Nombre	Tipo	Descripción
`table`	`DataTableSource`	Es la tabla de datos que se usará para el gráfico.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`setDataViewDefinition(dataViewDefinition)`

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

Parámetros

Nombre	Tipo	Descripción
`dataViewDefinition`	`DataViewDefinition`	Es 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.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`setDimensions(width, height)`

Establece las dimensiones del gráfico.

Parámetros

Nombre	Tipo	Descripción
`width`	`Integer`	Es el ancho del gráfico, en píxeles.
`height`	`Integer`	Es la altura del gráfico, en píxeles.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`setFirstRowNumber(number)`

Establece el número de fila para 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

Nombre	Tipo	Descripción
`number`	`Integer`	Es el número de fila de la primera fila de la tabla de datos.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`setInitialSortingAscending(column)`

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

La columna está ordenada de forma 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

Nombre	Tipo	Descripción
`column`	`Integer`	Es el número de la columna según el cual se debe ordenar la tabla inicialmente.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`setInitialSortingDescending(column)`

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

La columna está ordenada de forma 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

Nombre	Tipo	Descripción
`column`	`Integer`	Es el número de la columna según el cual se debe ordenar la tabla inicialmente.

Volver

TableChartBuilder: Este compilador es ú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 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

Nombre	Tipo	Descripción
`option`	`String`	La opción que se debe configurar.
`value`	`Object`	El valor que se establecerá.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`showRowNumberColumn(showRowNumber)`

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

El comportamiento predeterminado no muestra los números de fila.

Parámetros

Nombre	Tipo	Descripción
`showRowNumber`	`Boolean`	`true` si la primera columna de la tabla debe mostrar el número de fila, `false` de lo contrario.

Volver

TableChartBuilder: Este compilador es útil para encadenar.

`useAlternatingRowStyle(alternate)`

Establece si se asigna un estilo de color alternativo 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

Nombre	Tipo	Descripción
`alternate`	`Boolean`	`true` si los estilos de color deben alternarse, `false` de lo contrario.

Volver

TableChartBuilder: Este compilador es útil para encadenar.