Compilateur pour les tableaux. Pour en savoir plus, consultez la documentation sur les graphiques Google.
Voici un exemple illustrant comment créer un graphique sous forme de tableau. Les données sont importées à partir d'une feuille de calcul Google.
// Get sample data from a spreadsheet.
var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
'&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';
var chartBuilder = Charts.newTableChart()
.setDimensions(600, 500)
.enablePaging(20)
.setDataSourceUrl(dataSourceUrl);
var chart = chartBuilder.build();
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
enablePaging(enablePaging) | TableChartBuilder | Détermine si la pagination des données doit être activée. |
enablePaging(pageSize) | TableChartBuilder | Active la pagination et définit le nombre de lignes dans chaque page. |
enablePaging(pageSize, startPage) | TableChartBuilder | Active la pagination, définit le nombre de lignes de chaque page et la première page de tableau à afficher (les numéros de page sont basés sur zéro). |
enableRtlTable(rtlEnabled) | TableChartBuilder | Ajout de la prise en charge de base des langues qui se lisent de droite à gauche (telles que l'arabe ou l'hébreu) en inversant l'ordre des colonnes de la table, de sorte que la colonne 0 soit la colonne la plus à droite et que la dernière colonne soit la plus à gauche. |
enableSorting(enableSorting) | TableChartBuilder | Détermine si les colonnes doivent être triées lorsque l'utilisateur clique sur un en-tête de colonne. |
setDataSourceUrl(url) | TableChartBuilder | Définit l'URL de la source de données utilisée pour extraire des données d'une source externe, telle que Google Sheets. |
setDataTable(tableBuilder) | TableChartBuilder | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
setDataTable(table) | TableChartBuilder | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Définit la définition de la vue des données à utiliser pour le graphique. |
setDimensions(width, height) | TableChartBuilder | Définit les dimensions du graphique. |
setFirstRowNumber(number) | TableChartBuilder | Définit le numéro de la première ligne du tableau de données. |
setInitialSortingAscending(column) | TableChartBuilder | Définit l'index de la colonne en fonction de lequel la table doit être initialement triée (ordre croissant). |
setInitialSortingDescending(column) | TableChartBuilder | Définit l'index de la colonne en fonction de lequel la table doit être initialement triée (ordre décroissant). |
setOption(option, value) | TableChartBuilder | Définit les options avancées de ce graphique. |
showRowNumberColumn(showRowNumber) | TableChartBuilder | Détermine si le numéro de ligne doit être affiché en tant que première colonne du tableau. |
useAlternatingRowStyle(alternate) | TableChartBuilder | Détermine si le style de couleurs en alternance est attribué aux lignes paires et impaires d'un tableau. |
Documentation détaillée
build()
Crée le graphique.
Renvois
Chart : objet de graphique pouvant être intégré à des documents ou des éléments d'interface utilisateur, ou utilisé comme image statique.
enablePaging(enablePaging)
Détermine si la pagination des données doit être activée.
Par défaut, la pagination est désactivée. Si la pagination est activée, la taille de page par défaut est de 10.
Paramètres
| Nom | Type | Description |
|---|---|---|
enablePaging | Boolean | true si la pagination doit être activée, false dans le cas contraire. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
enablePaging(pageSize)
Active la pagination et définit le nombre de lignes dans chaque page.
La taille de page par défaut est de 10.
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
Paramètres
| Nom | Type | Description |
|---|---|---|
pageSize | Integer | Nombre de lignes dans chaque page du tableau. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
enablePaging(pageSize, startPage)
Active la pagination, définit le nombre de lignes de chaque page et la première page de tableau à afficher (les numéros de page sont basés sur zéro).
La taille de page par défaut est 10. La page d'accueil par défaut est 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
Paramètres
| Nom | Type | Description |
|---|---|---|
pageSize | Integer | Nombre de lignes dans chaque page du tableau. |
startPage | Integer | Première page du tableau à afficher (les numéros de page sont basés sur zéro). |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
enableRtlTable(rtlEnabled)
Ajout de la prise en charge de base des langues qui se lisent de droite à gauche (telles que l'arabe ou l'hébreu) en inversant l'ordre des colonnes de la table, de sorte que la colonne 0 soit la colonne la plus à droite et que la dernière colonne soit la plus à gauche.
Cela n'affecte pas l'index de colonne dans les données sous-jacentes, mais uniquement l'ordre d'affichage. L'affichage bidirectionnel complet (BiDi) n'est pas compatible avec la visualisation de table, même avec cette option. Cette option est ignorée si vous activez la pagination (à l'aide de l'option de page) ou si le tableau comporte des barres de défilement, car vous avez spécifié des options de hauteur et de largeur inférieures à la taille requise pour le tableau. Par défaut, la prise en charge des langues qui se lisent de droite à gauche est désactivée.
Paramètres
| Nom | Type | Description |
|---|---|---|
rtlEnabled | Boolean | true si la compatibilité avec la lecture de droite à gauche doit être activée, false dans le cas contraire. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
enableSorting(enableSorting)
Détermine si les colonnes doivent être triées lorsque l'utilisateur clique sur un en-tête de colonne.
Si le tri est activé, les lignes sont automatiquement triées lorsque les utilisateurs cliquent sur l'en-tête de la colonne. Par défaut, le tri est activé.
Paramètres
| Nom | Type | Description |
|---|---|---|
enableSorting | Boolean | true pour activer le tri en cliquant sur les en-têtes des colonnes, ou sur false dans le cas contraire. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setDataSourceUrl(url)
Définit l'URL de la source de données utilisée pour extraire des données d'une source externe, telle que Google Sheets. Si une URL de source de données et un DataTable sont fournis, l'URL de la source de données est ignorée.
Pour en savoir plus sur l'interrogation des sources de données, consultez la documentation sur Google Charts.
Paramètres
| Nom | Type | Description |
|---|---|---|
url | String | URL de la source de données, y compris les paramètres de requête. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setDataTable(tableBuilder)
Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. Il s'agit d'une méthode pratique permettant de définir la table de données sans avoir à appeler build().
Paramètres
| Nom | Type | Description |
|---|---|---|
tableBuilder | DataTableBuilder | Générateur de tableaux de données. Un nouveau tableau de données est créé instantanément lors de cet appel. Par conséquent, toute mise à jour ultérieure du compilateur ne sera pas reflétée dans le graphique. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setDataTable(table)
Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. La première colonne doit contenir une chaîne contenant les libellés de l'axe horizontal. N’importe quel nombre de colonnes peut suivre, toutes doivent être numériques. Chaque colonne s'affiche sur une ligne distincte.
Paramètres
| Nom | Type | Description |
|---|---|---|
table | DataTableSource | Tableau de données à utiliser pour le graphique. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setDataViewDefinition(dataViewDefinition)
Définit la définition de la vue des données à utiliser pour le graphique.
Paramètres
| Nom | Type | Description |
|---|---|---|
dataViewDefinition | DataViewDefinition | Objet de définition de vue de données qui définit la vue devant être dérivée de la source de données indiquée pour le dessin de graphique. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setDimensions(width, height)
Définit les dimensions du graphique.
Paramètres
| Nom | Type | Description |
|---|---|---|
width | Integer | Largeur du graphique, en pixels. |
height | Integer | Hauteur du graphique, en pixels. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setFirstRowNumber(number)
Définit le numéro de la première ligne du tableau de données.
Le numéro de ligne par défaut de la première ligne est 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Integer | Numéro de la première ligne du tableau de données. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setInitialSortingAscending(column)
Définit l'index de la colonne en fonction de lequel la table doit être initialement triée (ordre croissant).
La colonne os triée par ordre croissant et est marquée d’une petite flèche indiquant cela.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
Paramètres
| Nom | Type | Description |
|---|---|---|
column | Integer | Numéro de la colonne en fonction de laquelle le tableau doit être initialement trié. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setInitialSortingDescending(column)
Définit l'index de la colonne en fonction de lequel la table doit être initialement triée (ordre décroissant).
La colonne os triée par ordre décroissant et est marquée d’une petite flèche indiquant que cela.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
Paramètres
| Nom | Type | Description |
|---|---|---|
column | Integer | Numéro de la colonne en fonction de laquelle le tableau doit être initialement trié. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
setOption(option, value)
Définit les options avancées de ce graphique. Consultez les options disponibles pour ce graphique. Cette méthode n'a aucun effet si l'option donnée n'est pas valide.
// Build a table chart which renders HTML.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();
Paramètres
| Nom | Type | Description |
|---|---|---|
option | String | Option à définir. |
value | Object | Valeur à définir. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
showRowNumberColumn(showRowNumber)
Détermine si le numéro de ligne doit être affiché en tant que première colonne du tableau.
Par défaut, les numéros de ligne ne sont pas affichés.
Paramètres
| Nom | Type | Description |
|---|---|---|
showRowNumber | Boolean | true si la première colonne du tableau doit afficher le numéro de ligne, et false dans le cas contraire. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.
useAlternatingRowStyle(alternate)
Détermine si le style de couleurs en alternance est attribué aux lignes paires et impaires d'un tableau.
Le comportement par défaut correspond aux lignes dont le style de couleurs est en alternance.
Paramètres
| Nom | Type | Description |
|---|---|---|
alternate | Boolean | true si les styles de couleurs doivent être en alternance, et false dans le cas contraire. |
Renvois
TableChartBuilder : compilateur utile pour les chaînes.