Compilateur d'objets DataTable. La création d'une table de données consiste à spécifier d'abord ses colonnes, puis puis en ajoutant ses 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 du 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 étiquettes (par exemple, les étiquettes de l'axe X sur des lignes graphiques ou libellés de secteurs dans les graphiques à secteurs). Les autres colonnes sont souvent utilisées pour les données. nécessitent souvent des valeurs numériques.
Paramètres
Nom | Type | Description |
---|---|---|
type | ColumnType | le type de données de la colonne (nombre, chaîne ou date) ; |
label | String | étiquette de la colonne (il est utilisé pour les légendes des graphiques). |
Renvois
DataTableBuilder
: compilateur pour le chaînage.
addRow(values)
Ajoute une ligne à la table de données.
Paramètres
Nom | Type | Description |
---|---|---|
values | Object[] | de la ligne, spécifiées dans l'ordre dans lequel les colonnes sont saisies. |
Renvois
DataTableBuilder
: compilateur pour le chaînage.
build()
setValue(row, column, value)
Définit une valeur spécifique du tableau.
Vous pouvez définir une valeur avant d'ajouter la colonne à la table de données. Toutefois, à moins que la colonne est ajoutée à un moment donné, la valeur est 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'index de ligne (la première ligne a l'index 0) ; |
column | Integer | l'index de la colonne (la première colonne a l'index 0) ; |
value | Object | la valeur de la cellule du tableau (elle doit présenter le type de colonne approprié). |
Renvois
DataTableBuilder
: compilateur, pour le chaînage