Compilateur d'objets DataTable. La création d'une table de données consiste à spécifier les colonnes correspondantes, puis à ajouter les lignes une par une. Exemple :
var 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 le tableau. |
Documentation détaillée
addColumn(type, label)
Ajoute une colonne à la table de données. Les colonnes seront ajoutées de 0 à n.
La première colonne est souvent utilisée dans les graphiques pour les libellés (par exemple, les libellés de l'axe X sur les graphiques en courbes ou les libellés des secteurs dans les graphiques à 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 de la colonne (nombre, chaîne ou date) |
label | String | libellé de la colonne (utilisé pour les légendes de graphique). |
Renvois
DataTableBuilder
: compilateur, pour le chaînage.
addRow(values)
Ajoute une ligne à la table de données.
Paramètres
Nom | Type | Description |
---|---|---|
values | Object[] | des valeurs pour la ligne, spécifiées dans l'ordre dans lequel les colonnes sont entrées. |
Renvois
DataTableBuilder
: compilateur, pour le chaînage.
build()
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, la valeur sera ignorée, sauf si la colonne est ajoutée à un moment donné.
Il n'est pas nécessaire de renseigner toutes les valeurs des colonnes. Ceux qui sont manquants seront considérés comme null
.
Paramètres
Nom | Type | Description |
---|---|---|
row | Integer | L'index de ligne (la première ligne a l'index 0) |
column | Integer | l'index de colonne (l'index de la première colonne est 0) ; |
value | Object | la valeur de la cellule du tableau (doit avoir le type approprié pour la colonne). |
Renvois
DataTableBuilder
: ce compilateur, pour le chaînage