Class DataTableBuilder

Outil de création de table de données

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 au tableau de données.
addRow(values)	DataTableBuilder	Ajoute une ligne au tableau de données.
build()	DataTable	Crée et affiche un tableau de données.
setValue(row, column, value)	DataTableBuilder	Définit une valeur spécifique dans le tableau.

Documentation détaillée

addColumn(type, label)

Ajoute une colonne au tableau de données. Les colonnes seront 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 X dans les graphiques linéaires ou les libellés des segments dans les graphiques circulaires). 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 de 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 au tableau de données.

Paramètres

Nom	Type	Description
values	Object[]	valeurs de la ligne, spécifiées dans l'ordre dans lequel les colonnes sont saisies.

Renvois

DataTableBuilder : ce compilateur, pour le chaînage.

---

build()

Crée et affiche un tableau de données.

Renvois

DataTable : tableau 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 le tableau.

Vous pouvez définir une valeur avant d'ajouter la colonne au tableau 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 des colonnes. Les éléments manquants seront considérés comme null.

Paramètres

Nom	Type	Description
row	Integer	l'indice de ligne (la première ligne a l'indice 0) ;
column	Integer	l'indice de colonne (la première colonne a l'indice 0) ;
value	Object	la valeur de la cellule du tableau (elle doit être du bon type pour la colonne).

Renvois

DataTableBuilder : ce compilateur, pour le chaînage