Class DataTableBuilder

Creador detablas de datos

Es un compilador de objetos DataTable. La compilación de una tabla de datos consiste en especificar primero sus columnas y, luego, agregar sus filas, una a la vez. Ejemplo: 

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

Métodos

MétodoTipo de datos que se muestraDescripción breve
addColumn(type, label)DataTableBuilderAgrega una columna a la tabla de datos.
addRow(values)DataTableBuilderAgrega una fila a la tabla de datos.
build()DataTableCompila y muestra una tabla de datos.
setValue(row, column, value)DataTableBuilderEstablece un valor específico en la tabla.

Documentación detallada

addColumn(type, label)

Agrega una columna a la tabla de datos. Las columnas se agregarán del 0 al n.

Los gráficos suelen usar la primera columna para las etiquetas (por ejemplo, las etiquetas del eje X en los gráficos de líneas o las etiquetas de las porciones en los gráficos circulares). Las otras columnas suelen usarse para los datos y, por lo tanto, suelen requerir valores numéricos.

Parámetros

NombreTipoDescripción
typeColumnTypetipo de datos de la columna (número, cadena o fecha)
labelStringetiqueta de la columna (se usa para las leyendas de los gráficos).

Volver

DataTableBuilder: Este compilador, para encadenar.

addRow(values)

Agrega una fila a la tabla de datos.

Parámetros

NombreTipoDescripción
valuesObject[]valores de la fila, especificados en el mismo orden en que se ingresan las columnas.

Volver

DataTableBuilder: Este compilador, para encadenar.

build()

Compila y muestra una tabla de datos.

Volver

DataTable: La tabla de datos

Arroja

Error: Si la tabla de datos está vacía o tiene un formato incorrecto.

setValue(row, column, value)

Establece un valor específico en la tabla.

Puedes establecer un valor antes de agregar la columna a la tabla de datos. Sin embargo, a menos que se agregue la columna en algún momento, se ignorará el valor.

No es necesario completar todos los valores de las columnas. Los que falten se considerarán null.

Parámetros

NombreTipoDescripción
rowIntegerel índice de fila (la primera fila tiene el índice 0)
columnIntegerel índice de la columna (la primera columna tiene el índice 0)
valueObjectel valor de la celda de la tabla (debe tener el tipo correcto para la columna)

Volver

DataTableBuilder: Este compilador, para encadenar