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

Class ColumnChartBuilder

Outil de création de graphiques à colonnes. Pour en savoir plus, consultez la documentation Google Charts.

Cet exemple montre comment créer un graphique à colonnes à partir des données d'un tableau de données.

const sampleData = Charts.newDataTable()
                       .addColumn(Charts.ColumnType.STRING, 'Year')
                       .addColumn(Charts.ColumnType.NUMBER, 'Sales')
                       .addColumn(Charts.ColumnType.NUMBER, 'Expenses')
                       .addRow(['2004', 1000, 400])
                       .addRow(['2005', 1170, 460])
                       .addRow(['2006', 660, 1120])
                       .addRow(['2007', 1030, 540])
                       .addRow(['2008', 800, 600])
                       .addRow(['2009', 943, 678])
                       .addRow(['2010', 1020, 550])
                       .addRow(['2011', 910, 700])
                       .addRow(['2012', 1230, 840])
                       .build();

const chart = Charts.newColumnChart()
                  .setTitle('Sales & Expenses')
                  .setXAxisTitle('Year')
                  .setYAxisTitle('Amount (USD)')
                  .setDimensions(600, 500)
                  .setDataTable(sampleData)
                  .build();

Méthodes

Méthode	Type renvoyé	Brève description
`build()`	`Chart`	Crée le graphique.
`reverseCategories()`	`ColumnChartBuilder`	Inverse le dessin des séries sur l'axe des domaines.
`setBackgroundColor(cssValue)`	`ColumnChartBuilder`	Définit la couleur d'arrière-plan du graphique.
`setColors(cssValues)`	`ColumnChartBuilder`	Définit les couleurs des lignes du graphique.
`setDataSourceUrl(url)`	`ColumnChartBuilder`	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)`	`ColumnChartBuilder`	Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder.
`setDataTable(table)`	`ColumnChartBuilder`	Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe des abscisses.
`setDataViewDefinition(dataViewDefinition)`	`ColumnChartBuilder`	Définit la définition de la vue de données à utiliser pour le graphique.
`setDimensions(width, height)`	`ColumnChartBuilder`	Définit les dimensions du graphique.
`setLegendPosition(position)`	`ColumnChartBuilder`	Définit la position de la légende par rapport au graphique.
`setLegendTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style de texte de la légende du graphique.
`setOption(option, value)`	`ColumnChartBuilder`	Définit les options avancées de ce graphique.
`setRange(start, end)`	`ColumnChartBuilder`	Définit la plage du graphique.
`setStacked()`	`ColumnChartBuilder`	Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (accumulées).
`setTitle(chartTitle)`	`ColumnChartBuilder`	Définit le titre du graphique.
`setTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style de texte du titre du graphique.
`setXAxisTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style de texte de l'axe horizontal.
`setXAxisTitle(title)`	`ColumnChartBuilder`	Ajoute un titre à l'axe horizontal.
`setXAxisTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style de texte du titre de l'axe horizontal.
`setYAxisTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style de texte de l'axe vertical.
`setYAxisTitle(title)`	`ColumnChartBuilder`	Ajoute un titre à l'axe vertical.
`setYAxisTitleTextStyle(textStyle)`	`ColumnChartBuilder`	Définit le style du texte du titre de l'axe vertical.
`useLogScale()`	`ColumnChartBuilder`	Convertit l'axe des valeurs en échelle logarithmique (toutes les valeurs doivent être positives).

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.

`reverseCategories()`

Inverse le dessin des séries sur l'axe des domaines. Pour les graphiques à plage verticale (comme les graphiques en courbes, en aires ou à colonnes), cela signifie que l'axe horizontal est dessiné de droite à gauche. Pour les graphiques à plage horizontale (comme les graphiques en barres), cela signifie que l'axe vertical est dessiné de haut en bas. Pour les graphiques à secteurs, cela signifie que les segments sont dessinés dans le sens inverse des aiguilles d'une montre.

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

Renvois

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

`setBackgroundColor(cssValue)`

Définit la couleur d'arrière-plan du graphique.

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

Paramètres

Nom	Type	Description
`cssValue`	`String`	Valeur CSS de la couleur (par exemple, `"blue"` ou `"#00f"`).

Renvois

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

`setColors(cssValues)`

Définit les couleurs des lignes du graphique.

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

Paramètres

Nom	Type	Description
`cssValues`	`String[]`	Tableau de valeurs CSS de couleur, telles que `["red", "#acf"]`. L'élément n du tableau représente la couleur de la ligne n du graphique.

Renvois

ColumnChartBuilder : 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

ColumnChartBuilder : 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

ColumnChartBuilder : 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

ColumnChartBuilder : 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

ColumnChartBuilder : 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

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

`setLegendPosition(position)`

Définit la position de la légende par rapport au graphique. Par défaut, aucune légende n'est affichée.

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Paramètres

Nom	Type	Description
`position`	`Position`	Position de la légende.

Renvois

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

`setLegendTextStyle(textStyle)`

Définit le style de texte de la légende du graphique.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour la légende du graphique.

Renvois

ColumnChartBuilder : 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 column chart with a 1-second animation duration.
const builder = Charts.newColumnChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

Paramètres

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

Renvois

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

`setRange(start, end)`

Définit la plage du graphique.

Si des points de données se trouvent en dehors de la plage, la plage est étendue pour les inclure.

Paramètres

Nom	Type	Description
`start`	`Number`	Valeur de la ligne de grille la plus basse de l'axe des plages.
`end`	`Number`	Valeur de la ligne de grille la plus élevée de l'axe des valeurs.

Renvois

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

`setStacked()`

Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (accumulées). Par défaut, aucune superposition n'est appliquée.

Renvois

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

`setTitle(chartTitle)`

Définit le titre du graphique. Le titre s'affiche centré au-dessus du graphique.

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

Paramètres

Nom	Type	Description
`chartTitle`	`String`	le titre du graphique.

Renvois

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

`setTitleTextStyle(textStyle)`

Définit le style de texte du titre du graphique.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour le titre du graphique. Vous pouvez créer un objet `TextStyleBuilder` en appelant `Charts.newTextStyle()`.

Renvois

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

`setXAxisTextStyle(textStyle)`

Définit le style de texte de l'axe horizontal.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet `TextStyleBuilder` en appelant `Charts.newTextStyle()`.

Renvois

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

`setXAxisTitle(title)`

Ajoute un titre à l'axe horizontal. Le titre est centré et apparaît sous les libellés de valeur des axes.

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

Paramètres

Nom	Type	Description
`title`	`String`	Titre de l'axe X.

Renvois

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

`setXAxisTitleTextStyle(textStyle)`

Définit le style de texte du titre de l'axe horizontal.

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet `TextStyleBuilder` en appelant `Charts.newTextStyle()`.

Renvois

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

`setYAxisTextStyle(textStyle)`

Définit le style de texte de l'axe vertical.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet `TextStyleBuilder` en appelant `Charts.newTextStyle()`.

Renvois

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

`setYAxisTitle(title)`

Ajoute un titre à l'axe vertical. Le titre est centré et apparaît à gauche des libellés de valeur.

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

Paramètres

Nom	Type	Description
`title`	`String`	Titre de l'axe Y.

Renvois

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

`setYAxisTitleTextStyle(textStyle)`

Définit le style du texte du titre de l'axe vertical.

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Paramètres

Nom	Type	Description
`textStyle`	`TextStyle`	Style de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet `TextStyleBuilder` en appelant `Charts.newTextStyle()`.

Renvois

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

`useLogScale()`

Convertit l'axe des valeurs en échelle logarithmique (toutes les valeurs doivent être positives). L'axe des valeurs est l'axe vertical pour les graphiques verticaux (comme les graphiques en courbes, en aires ou en colonnes) et l'axe horizontal pour les graphiques horizontaux (comme les graphiques à barres).

Renvois

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