Class ScatterChartBuilder

ScatterChartBuilder

Compilateur pour les graphiques à nuage de points. Pour en savoir plus, consultez la documentation sur les graphiques Google.

Voici un exemple qui montre comment créer un graphique à nuage de points. 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=C1%3AD' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

var chartBuilder = Charts.newScatterChart()
    .setTitle('Adjusted GDP & U.S. Population')
    .setXAxisTitle('U.S. Population (millions)')
    .setYAxisTitle('Adjusted GDP ($ billions)')
    .setDimensions(600, 500)
    .setLegendPosition(Charts.Position.NONE)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Méthodes

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

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.


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

ScatterChartBuilder : compilateur utile pour les chaînes.


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 couleurs, par exemple ["red", "#acf"]. Le n-ième élément du tableau représente la couleur de la n-ième ligne du graphique.

Renvois

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

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

Renvois

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

NomTypeDescription
tableBuilderDataTableBuilderGé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

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

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

Renvois

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

NomTypeDescription
dataViewDefinitionDataViewDefinitionObjet 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

ScatterChartBuilder : compilateur utile pour les chaînes.


setDimensions(width, height)

Définit les dimensions du graphique.

Paramètres

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

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


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

ScatterChartBuilder : compilateur utile pour les chaînes.


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.
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

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

Paramètres

NomTypeDescription
optionStringOption à définir.
valueObjectValeur à définir.

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


setPointStyle(style)

Définit le style des points de la ligne. Par défaut, les points n'ont pas de style particulier et seule 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

ScatterChartBuilder : compilateur utile pour les chaînes.

Voir aussi


setTitle(chartTitle)

Définit le titre du graphique. Le titre est centré au-dessus 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

ScatterChartBuilder : compilateur utile pour les chaînes.


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.
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

ScatterChartBuilder : compilateur utile pour les chaînes.


setXAxisLogScale()

Convertit l'axe horizontal en échelle logarithmique (toutes les valeurs doivent être positives).

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


setXAxisRange(start, end)

Définit la plage de l'axe horizontal du graphique.

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Paramètres

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

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


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.
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

ScatterChartBuilder : compilateur utile pour les chaînes.


setXAxisTitle(title)

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

// 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 abscisses.

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


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

ScatterChartBuilder : compilateur utile pour les chaînes.


setYAxisLogScale()

Convertit l'axe vertical en échelle logarithmique (nécessite que toutes les valeurs soient positives).

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


setYAxisRange(start, end)

Définit la plage de l'axe vertical du graphique. Si des points de données se situent en dehors de la plage, la plage est étendue pour inclure ces points de données.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Paramètres

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

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


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.
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

ScatterChartBuilder : compilateur utile pour les chaînes.


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.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Paramètres

NomTypeDescription
titleStringTitre de l'axe Y.

Renvois

ScatterChartBuilder : compilateur utile pour les chaînes.


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

ScatterChartBuilder : compilateur utile pour les chaînes.