Class DataTableBuilder

DataTableBuilder

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 devuelveDescripció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 de 0 a 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 en 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 el encadenamiento.

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 el encadenamiento.

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 la 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 el encadenamiento