Class TableChartBuilder

TableChartBuilder

Compilateur pour les tableaux. Pour en savoir plus, consultez la documentation sur Google Charts.

Voici un exemple qui montre comment créer un 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éthodeType renvoyéBrève description
build()ChartCrée le graphique.
enablePaging(enablePaging)TableChartBuilderDétermine si la pagination des données doit être activée.
enablePaging(pageSize)TableChartBuilderActive la pagination et définit le nombre de lignes dans chaque page.
enablePaging(pageSize, startPage)TableChartBuilderActive la pagination, définit le nombre de lignes de chaque page et la première page de tableau à afficher (page les nombres sont basés sur zéro).
enableRtlTable(rtlEnabled)TableChartBuilderAjout de la prise en charge de base pour les langues qui se lisent de droite à gauche (telles que l'arabe ou l'hébreu) en inversant les options ordre des colonnes du tableau, de sorte que la colonne zéro est la colonne la plus à droite et que la dernière colonne soit la colonne la plus à gauche.
enableSorting(enableSorting)TableChartBuilderDétermine si les colonnes doivent être triées lorsque l'utilisateur clique sur un en-tête de colonne.
setDataSourceUrl(url)TableChartBuilderDéfinit l'URL de la source de données utilisée pour extraire des données d'une source externe, telle que Google Google Sheets.
setDataTable(tableBuilder)TableChartBuilderDéfinit la table de données à utiliser pour le graphique à l'aide de DataTableBuilder.
setDataTable(table)TableChartBuilderDéfinit le tableau de données qui contient les lignes du graphique, ainsi que les libellés de l'axe X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderDéfinit la définition de la vue de données à utiliser pour le graphique.
setDimensions(width, height)TableChartBuilderDéfinit les dimensions du graphique.
setFirstRowNumber(number)TableChartBuilderDéfinit le numéro de la première ligne du tableau de données.
setInitialSortingAscending(column)TableChartBuilderDéfinit l'index de la colonne en fonction duquel le tableau doit être trié initialement (ordre croissant).
setInitialSortingDescending(column)TableChartBuilderDéfinit l'index de la colonne en fonction duquel le tableau doit être trié initialement (ordre décroissant).
setOption(option, value)TableChartBuilderDéfinit les options avancées de ce graphique.
showRowNumberColumn(showRowNumber)TableChartBuilderDétermine si le numéro de ligne doit apparaître dans la première colonne du tableau.
useAlternatingRowStyle(alternate)TableChartBuilderDétermine si un style de couleurs alternées est attribué aux lignes impaires et paires d'un tableau.

Documentation détaillée

build()

Crée le graphique.

Renvois

Chart : objet Chart qui peut être intégré à des documents ou à des éléments d'interface utilisateur, ou utilisé en tant que graphique l'image.


enablePaging(enablePaging)

Détermine si la pagination des données doit être activée.

Le comportement par défaut est la pagination désactivée. Si la pagination est activée, la taille de page par défaut est de 10.

Paramètres

NomTypeDescription
enablePagingBooleantrue si la pagination doit être activée, et false dans le cas contraire.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


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

NomTypeDescription
pageSizeIntegerNombre de lignes dans chaque page du tableau.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


enablePaging(pageSize, startPage)

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

La taille de page par défaut est 10 et 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

NomTypeDescription
pageSizeIntegerNombre de lignes dans chaque page du tableau.
startPageIntegerPremière page du tableau à afficher (les numéros de page sont basés sur des zéros).

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


enableRtlTable(rtlEnabled)

Ajout de la prise en charge de base pour les langues qui se lisent de droite à gauche (telles que l'arabe ou l'hébreu) en inversant les options ordre des colonnes du tableau, de sorte que la colonne zéro est la colonne la plus à droite et que la dernière colonne soit la colonne 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) en langage n'est pas pris en charge par la visualisation de table, même avec cette option. Cette option est ignorée si vous activez la pagination (à l'aide de l'option "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 au la taille de table requise. Par défaut, la prise en charge des langues RTL est désactivée.

Paramètres

NomTypeDescription
rtlEnabledBooleantrue si l'orientation de droite à gauche doit être activée, false sinon.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


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é, lorsque les utilisateurs cliquent sur l'en-tête de colonne, les lignes sont automatiquement triées. Par défaut, le tri est activé.

Paramètres

NomTypeDescription
enableSortingBooleantrue pour activer le tri en cliquant sur les en-têtes de colonne, false dans le cas contraire.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


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 Google Sheets. Si une URL de source de données et un tableau de données sont fournis, l'URL de la source de données est ignorée.

Pour savoir comment interroger des sources de données, consultez la documentation sur Google Charts.

Paramètres

NomTypeDescription
urlStringURL de la source de données, y compris les paramètres de requête.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setDataTable(tableBuilder)

Définit la table de données à utiliser pour le graphique à l'aide de DataTableBuilder. Il s'agit d'une méthode pratique pour définir la table de données sans avoir à appeler build().

Paramètres

NomTypeDescription
tableBuilderDataTableBuilderOutil de création de tableaux de données. Une table de données est créée instantanément , de sorte que les mises à jour ultérieures du compilateur ne soient pas reflétées dans le graphique.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setDataTable(table)

Définit le tableau de données qui contient les lignes du graphique, ainsi que les libellés de l'axe X. La la première colonne doit être une chaîne et contenir les libellés de l'axe horizontal. N'importe quel nombre de colonnes peuvent suivre, toutes doivent être numériques. Chaque colonne s'affiche sur une ligne distincte.

Paramètres

NomTypeDescription
tableDataTableSourceTable de données à utiliser pour le graphique.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setDataViewDefinition(dataViewDefinition)

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

Paramètres

NomTypeDescription
dataViewDefinitionDataViewDefinitionObjet de définition d'une vue de données qui définit la vue à laquelle issues de la source de données donnée pour le dessin du graphique.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setDimensions(width, height)

Définit les dimensions du graphique.

Paramètres

NomTypeDescription
widthIntegerLargeur du graphique, en pixels.
heightIntegerHauteur du graphique, en pixels.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setFirstRowNumber(number)

Définit le numéro de la première ligne du tableau de données.

Par défaut, le numéro 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

NomTypeDescription
numberIntegerNuméro de la première ligne du tableau de données.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setInitialSortingAscending(column)

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

La colonne os a été triée par ordre croissant et est marquée d'une petite flèche à cet effet.

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

Paramètres

NomTypeDescription
columnIntegerNuméro de la colonne en fonction de laquelle le tableau doit être trié initialement.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


setInitialSortingDescending(column)

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

La colonne os a été triée par ordre décroissant et une petite flèche indique cela.

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

Paramètres

NomTypeDescription
columnIntegerNuméro de la colonne en fonction de laquelle le tableau doit être trié initialement.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


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

NomTypeDescription
optionStringL'option à définir.
valueObjectValeur à définir.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


showRowNumberColumn(showRowNumber)

Détermine si le numéro de ligne doit apparaître dans la première colonne du tableau.

Le comportement par défaut n'affiche pas les numéros de ligne.

Paramètres

NomTypeDescription
showRowNumberBooleantrue si la première colonne du tableau doit afficher le numéro de ligne, false dans les autres cas.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.


useAlternatingRowStyle(alternate)

Détermine si un style de couleurs alternées est attribué aux lignes impaires et paires d'un tableau.

Le comportement par défaut correspond aux lignes avec un style de couleur en alternance.

Paramètres

NomTypeDescription
alternateBooleantrue si les styles de couleur doivent être alternés, false dans le cas contraire.

Renvois

TableChartBuilder : compilateur, utile pour les enchaînements.