Class DataTableBuilder

DataTableBuilder

Compilateur d'objets DataTable. Pour créer une table de données, vous devez d'abord spécifier ses colonnes, puis ajouter ses lignes une par une. Exemple :

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éthodes

Méthode	Type renvoyé	Brève description
addColumn(type, label)	DataTableBuilder	Ajoute une colonne à la table de données.
addRow(values)	DataTableBuilder	Ajoute une ligne à la table de données.
build()	DataTable	Crée et affiche une table de données.
setValue(row, column, value)	DataTableBuilder	Définit une valeur spécifique dans la table.

Documentation détaillée

addColumn(type, label)

Ajoute une colonne à la table de données. Les colonnes sont ajoutées de 0 à n.

La première colonne est souvent utilisée par les graphiques pour les libellés (par exemple, les libellés de l'axe des abscisses dans les graphiques linéaires ou les libellés des secteurs dans les graphiques en secteurs). Les autres colonnes sont souvent utilisées pour les données et nécessitent donc souvent des valeurs numériques.

Paramètres

Nom	Type	Description
type	ColumnType	Type de données dans la colonne (nombre, chaîne ou date)
label	String	Libellé de la colonne (utilisé pour les légendes des graphiques)

Renvois

DataTableBuilder : ce compilateur, pour le chaînage.

---

addRow(values)

Ajoute une ligne à la table de données.

Paramètres

Nom	Type	Description
values	Object[]	Valeurs de la ligne, spécifiées dans le même ordre que les colonnes.

Renvois

DataTableBuilder : ce compilateur, pour le chaînage.

---

build()

Crée et affiche une table de données.

Renvois

DataTable : la table de données

Génère

Error : si la table de données est vide ou mal formée

---

setValue(row, column, value)

Définit une valeur spécifique dans la table.

Vous pouvez définir une valeur avant d'ajouter la colonne à la table de données. Toutefois, si la colonne n'est pas ajoutée à un moment donné, la valeur sera ignorée.

Il n'est pas nécessaire de renseigner toutes les valeurs de colonne. Les valeurs manquantes seront considérées comme null.

Paramètres

Nom	Type	Description
row	Integer	Indice de la ligne (la première ligne a l'indice 0)
column	Integer	Indice de la colonne (la première colonne a l'indice 0)
value	Object	Valeur de la cellule du tableau (doit avoir le bon type pour la colonne)

Renvois

DataTableBuilder : ce compilateur, pour le chaînage