Class LineChartBuilder

LineChartBuilder

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

Voici un exemple qui montre comment créer un graphique en courbes. 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%3AG5' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1';

  var chartBuilder = Charts.newLineChart()
      .setTitle('Yearly Rainfall')
      .setXAxisTitle('Month')
      .setYAxisTitle('Rainfall (in)')
      .setDimensions(600, 500)
      .setCurveStyle(Charts.CurveStyle.SMOOTH)
      .setPointStyle(Charts.PointStyle.MEDIUM)
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Méthodes

MéthodeType renvoyéBrève description
build()ChartCrée le graphique.
reverseCategories()LineChartBuilderInverse le dessin d'une série sur l'axe du domaine.
setBackgroundColor(cssValue)LineChartBuilderDéfinit la couleur d'arrière-plan du graphique.
setColors(cssValues)LineChartBuilderDéfinit les couleurs des lignes du graphique.
setCurveStyle(style)LineChartBuilderDéfinit le style à utiliser pour les courbes du graphique.
setDataSourceUrl(url)LineChartBuilderDé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)LineChartBuilderDéfinit la table de données à utiliser pour le graphique à l'aide de DataTableBuilder.
setDataTable(table)LineChartBuilderDéfinit le tableau de données qui contient les lignes du graphique, ainsi que les libellés de l'axe X.
setDataViewDefinition(dataViewDefinition)LineChartBuilderDéfinit la définition de la vue de données à utiliser pour le graphique.
setDimensions(width, height)LineChartBuilderDéfinit les dimensions du graphique.
setLegendPosition(position)LineChartBuilderDéfinit la position de la légende par rapport au graphique.
setLegendTextStyle(textStyle)LineChartBuilderDéfinit le style du texte de la légende du graphique.
setOption(option, value)LineChartBuilderDéfinit les options avancées de ce graphique.
setPointStyle(style)LineChartBuilderDéfinit le style des points de la ligne.
setRange(start, end)LineChartBuilderDéfinit la plage du graphique.
setTitle(chartTitle)LineChartBuilderDéfinit le titre du graphique.
setTitleTextStyle(textStyle)LineChartBuilderDéfinit le style du texte du titre du graphique.
setXAxisTextStyle(textStyle)LineChartBuilderDéfinit le style du texte de l'axe horizontal.
setXAxisTitle(title)LineChartBuilderAjoute un titre à l'axe horizontal.
setXAxisTitleTextStyle(textStyle)LineChartBuilderDéfinit le style du texte du titre de l'axe horizontal.
setYAxisTextStyle(textStyle)LineChartBuilderDéfinit le style du texte de l'axe vertical.
setYAxisTitle(title)LineChartBuilderAjoute un titre à l'axe vertical.
setYAxisTitleTextStyle(textStyle)LineChartBuilderDéfinit le style du texte du titre de l'axe vertical.
useLogScale()LineChartBuilderTransforme l'axe de la plage sur une échelle logarithmique (toutes les valeurs doivent être positives).

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.


reverseCategories()

Inverse le dessin d'une série sur l'axe du domaine. Pour les graphiques à secteurs verticaux (tels que les graphiques en courbes, les graphiques en aires ou à colonnes), cela signifie que l'axe horizontal est tracé de droite à gauche. Pour les graphiques à barres horizontales (comme les graphiques à barres), l'axe vertical est tracé de haut en bas, en bas. Pour les graphiques à secteurs, cela signifie que les secteurs 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.
var builder = Charts.newPieChart();
builder.reverseCategories();

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setBackgroundColor(cssValue)

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

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

Paramètres

NomTypeDescription
cssValueStringValeur CSS de la couleur (par exemple, "blue" ou "#00f").

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Paramètres

NomTypeDescription
cssValuesString[]Tableau de valeurs CSS de couleur, par exemple ["red", "#acf"]. Le n-ième élément du tableau représente la couleur de la nième ligne du graphique.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setCurveStyle(style)

Définit le style à utiliser pour les courbes du graphique. Voir CurveStyle pour la courbe autorisée .

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

Paramètres

NomTypeDescription
styleCurveStyleStyle des courbes du graphique.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.

Voir aussi


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

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

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

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

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

LineChartBuilder : compilateur, utile pour les enchaînements.


setLegendPosition(position)

Définit la position de la légende par rapport au graphique. Par défaut, il n'y a pas de légende.

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

Paramètres

NomTypeDescription
positionPositionPosition de la légende.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setLegendTextStyle(textStyle)

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

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

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour la légende du graphique.

Renvois

LineChartBuilder : 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 line chart with a 1-second animation duration.
var builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Paramètres

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

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setPointStyle(style)

Définit le style des points de la ligne. Par défaut, les points n'ont pas de style particulier, la ligne est visible.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Paramètres

NomTypeDescription
stylePointStyleStyle à utiliser pour les points de la ligne.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.

Voir aussi


setRange(start, end)

Définit la plage du graphique.

Si des points de données se situent en dehors de la plage, celle-ci est étendue pour inclure ces données. points.

Paramètres

NomTypeDescription
startNumberValeur de la ligne de grille la plus basse de l'axe de la plage.
endNumberValeur de la ligne de grille la plus élevée de l'axe de la plage.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setTitle(chartTitle)

Définit le titre du graphique. Le titre est affiché au centre du graphique.

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

Paramètres

NomTypeDescription
chartTitleStringle titre du graphique.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setTitleTextStyle(textStyle)

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

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

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour le titre du graphique. Vous pouvez créer un objet TextStyleBuilder en appelant Charts.newTextStyle().

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setXAxisTextStyle(textStyle)

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

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

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet TextStyleBuilder en appelant Charts.newTextStyle().

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setXAxisTitle(title)

Ajoute un titre à l'axe horizontal. Le titre est centré et apparaît sous la valeur de l'axe étiquettes.

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

Paramètres

NomTypeDescription
titleStringTitre de l'axe des X.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setXAxisTitleTextStyle(textStyle)

Définit le style du 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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet TextStyleBuilder en appelant Charts.newTextStyle().

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setYAxisTextStyle(textStyle)

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

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

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet TextStyleBuilder en appelant Charts.newTextStyle().

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


setYAxisTitle(title)

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

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

Paramètres

NomTypeDescription
titleStringTitre de l'axe Y.

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


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.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Paramètres

NomTypeDescription
textStyleTextStyleStyle de texte à utiliser pour le titre de l'axe horizontal. Vous pouvez créer un objet TextStyleBuilder en appelant Charts.newTextStyle().

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.


useLogScale()

Transforme l'axe de la plage sur une échelle logarithmique (toutes les valeurs doivent être positives). La plage correspond à l'axe vertical des graphiques verticaux (lignes, zones ou colonnes, par exemple) et l'axe horizontal pour les graphiques horizontaux (comme les barres).

Renvois

LineChartBuilder : compilateur, utile pour les enchaînements.