Cette page a été traduite par l'API Cloud Translation.

Class TableChartBuilder

Un générateur de graphiques sous forme de tableaux. Pour en savoir plus, consultez la documentation Google Charts.

Voici un exemple montrant 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.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

Méthodes

Méthode	Type renvoyé	Brève description
`build()`	`Chart`	Crée le graphique.
`enablePaging(enablePaging)`	`TableChartBuilder`	Indique si la pagination des données doit être activée.
`enablePaging(pageSize)`	`TableChartBuilder`	Active la pagination et définit le nombre de lignes de chaque page.
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	Active la pagination, définit le nombre de lignes sur chaque page et la première page du tableau à afficher (les numéros de page sont basés sur zéro).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	Ajoute une compatibilité de base avec les langues de droite à gauche (comme l'arabe ou l'hébreu) en inversant l'ordre des colonnes du tableau, de sorte que la colonne 0 soit la colonne la plus à droite et la dernière colonne la plus à gauche.
`enableSorting(enableSorting)`	`TableChartBuilder`	Indique si les colonnes doivent être triées lorsque l'utilisateur clique sur un titre de colonne.
`setDataSourceUrl(url)`	`TableChartBuilder`	Définit l'URL de la source de données utilisée pour extraire des données à partir 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 des abscisses.
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	Définit la définition de la vue de 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 laquelle le tableau doit être trié initialement (par ordre croissant).
`setInitialSortingDescending(column)`	`TableChartBuilder`	Définit l'index de la colonne en fonction de laquelle le tableau doit être trié initialement (décroissant).
`setOption(option, value)`	`TableChartBuilder`	Définit les options avancées de ce graphique.
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	Indique si le numéro de ligne doit être affiché dans la première colonne du tableau.
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	Indique si un style de couleur alterné est attribué aux lignes impaires et paires d'un tableau.

Documentation détaillée

`build()`

Crée le graphique.

Renvois

Chart : objet graphique pouvant être intégré à des documents, à des éléments d'interface utilisateur ou utilisé comme image statique.

`enablePaging(enablePaging)`

Indique 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 : ce compilateur est utile pour le chaînage.

`enablePaging(pageSize)`

Active la pagination et définit le nombre de lignes de 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.
const builder = Charts.newTableChart();
builder.enablePaging(5);

Paramètres

Nom	Type	Description
`pageSize`	`Integer`	Nombre de lignes sur chaque page de la table.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`enablePaging(pageSize, startPage)`

Active la pagination, définit le nombre de lignes sur chaque page et la première page du tableau à afficher (les numéros de page sont basés sur zéro).

La taille de page par défaut est de 10 et la page de démarrage par défaut est 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Paramètres

Nom	Type	Description
`pageSize`	`Integer`	Nombre de lignes sur chaque page de la table.
`startPage`	`Integer`	Première page du tableau à afficher (les numéros de page sont basés sur zéro).

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`enableRtlTable(rtlEnabled)`

Ajoute une compatibilité de base avec les langues de droite à gauche (comme l'arabe ou l'hébreu) en inversant l'ordre des colonnes du tableau, de sorte que la colonne 0 soit la colonne la plus à droite et la dernière colonne la plus à gauche.

Cela n'affecte pas l'indice de colonne dans les données sous-jacentes, mais uniquement l'ordre d'affichage. La visualisation de la table n'est pas compatible avec l'affichage complet des langues bidirectionnelles, 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 du tableau. Par défaut, la prise en charge de l'écriture arabe est désactivée.

Paramètres

Nom	Type	Description
`rtlEnabled`	`Boolean`	`true` si la prise en charge de la lecture de droite à gauche doit être activée, `false` dans le cas contraire.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`enableSorting(enableSorting)`

Indique si les colonnes doivent être triées lorsque l'utilisateur clique sur un titre de colonne.

Si le tri est activé, les lignes sont triées automatiquement lorsque les utilisateurs cliquent sur l'en-tête de 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 de colonne, `false` dans le cas contraire.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`setDataSourceUrl(url)`

Définit l'URL de la source de données utilisée pour extraire des données à partir d'une source externe, telle que Google Sheets. Si une URL de source de données et une DataTable sont fournies, 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 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 : ce compilateur est utile pour le chaînage.

`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 pour définir le tableau de données sans avoir à appeler build().

Paramètres

Nom	Type	Description
`tableBuilder`	`DataTableBuilder`	Un outil de création de tableaux de données. Une nouvelle table de données est créée instantanément dans le cadre de cet appel. Par conséquent, toute autre mise à jour du générateur ne sera pas reflétée dans le graphique.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`setDataTable(table)`

Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe des abscisses. La première colonne doit être une chaîne et contenir les libellés de l'axe horizontal. Un nombre illimité 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 : ce compilateur est utile pour le chaînage.

`setDataViewDefinition(dataViewDefinition)`

Définit la définition de la vue de données à utiliser pour le graphique.

Paramètres

Nom	Type	Description
`dataViewDefinition`	`DataViewDefinition`	Objet de définition de la vue de données qui définit la vue à dériver de la source de données donnée pour le dessin du graphique.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`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 : ce compilateur est utile pour le chaînage.

`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.
const 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 : ce compilateur est utile pour le chaînage.

`setInitialSortingAscending(column)`

Définit l'index de la colonne en fonction de laquelle le tableau doit être trié initialement (par ordre croissant).

La colonne est triée par ordre croissant, ce qui est indiqué par une petite flèche.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Paramètres

Nom	Type	Description
`column`	`Integer`	Numéro de la colonne en fonction de laquelle la table doit être triée initialement.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`setInitialSortingDescending(column)`

Définit l'index de la colonne en fonction de laquelle le tableau doit être trié initialement (décroissant).

La colonne est triée par ordre décroissant et est marquée d'une petite flèche.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Paramètres

Nom	Type	Description
`column`	`Integer`	Numéro de la colonne en fonction de laquelle la table doit être triée initialement.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`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.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

Paramètres

Nom	Type	Description
`option`	`String`	Option à définir.
`value`	`Object`	Valeur à définir.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`showRowNumberColumn(showRowNumber)`

Indique si le numéro de ligne doit être affiché dans la 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, `false` sinon.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.

`useAlternatingRowStyle(alternate)`

Indique si un style de couleur alterné est attribué aux lignes impaires et paires d'un tableau.

Par défaut, les lignes alternent les styles de couleur.

Paramètres

Nom	Type	Description
`alternate`	`Boolean`	`true` si les styles de couleur doivent alterner, `false` dans le cas contraire.

Renvois

TableChartBuilder : ce compilateur est utile pour le chaînage.