Compilateur pour les graphiques à nuage de points. Pour en savoir plus, consultez la documentation sur Google Charts.
Voici un exemple montrant 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éthode | Type renvoyé | Brève description |
---|---|---|
build() | Chart | Crée le graphique. |
setBackgroundColor(cssValue) | ScatterChartBuilder | Définit la couleur d'arrière-plan du graphique. |
setColors(cssValues) | ScatterChartBuilder | Définit les couleurs des lignes du graphique. |
setDataSourceUrl(url) | ScatterChartBuilder | 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. |
setDataTable(tableBuilder) | ScatterChartBuilder | Définit la table de données à utiliser pour le graphique à l'aide de DataTableBuilder. |
setDataTable(table) | ScatterChartBuilder | Définit le tableau de données qui contient les lignes du graphique, ainsi que les libellés de l'axe X. |
setDataViewDefinition(dataViewDefinition) | ScatterChartBuilder | Définit la définition de la vue de données à utiliser pour le graphique. |
setDimensions(width, height) | ScatterChartBuilder | Définit les dimensions du graphique. |
setLegendPosition(position) | ScatterChartBuilder | Définit la position de la légende par rapport au graphique. |
setLegendTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte de la légende du graphique. |
setOption(option, value) | ScatterChartBuilder | Définit les options avancées de ce graphique. |
setPointStyle(style) | ScatterChartBuilder | Définit le style des points de la ligne. |
setTitle(chartTitle) | ScatterChartBuilder | Définit le titre du graphique. |
setTitleTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte du titre du graphique. |
setXAxisLogScale() | ScatterChartBuilder | Transforme l'axe horizontal en une échelle logarithmique (toutes les valeurs doivent être positives). |
setXAxisRange(start, end) | ScatterChartBuilder | Définit la plage correspondant à l'axe horizontal du graphique. |
setXAxisTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte de l'axe horizontal. |
setXAxisTitle(title) | ScatterChartBuilder | Ajoute un titre à l'axe horizontal. |
setXAxisTitleTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte du titre de l'axe horizontal. |
setYAxisLogScale() | ScatterChartBuilder | Transforme l'axe vertical en une échelle logarithmique (toutes les valeurs doivent être positives). |
setYAxisRange(start, end) | ScatterChartBuilder | Définit la plage de l'axe vertical du graphique. |
setYAxisTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte de l'axe vertical. |
setYAxisTitle(title) | ScatterChartBuilder | Ajoute un titre à l'axe vertical. |
setYAxisTitleTextStyle(textStyle) | ScatterChartBuilder | Définit le style du texte du titre de l'axe vertical. |
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.
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
Nom | Type | Description |
---|---|---|
cssValue | String | Valeur CSS de la couleur (par exemple, "blue" ou "#00f" ). |
Renvois
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
cssValues | String[] | 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
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
url | String | URL de la source de données, y compris les paramètres de requête. |
Renvois
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
tableBuilder | DataTableBuilder | Outil 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
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
table | DataTableSource | Table de données à utiliser pour le graphique. |
Renvois
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
dataViewDefinition | DataViewDefinition | Objet 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
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
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
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
position | Position | Position de la légende. |
Renvois
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
textStyle | TextStyle | Style de texte à utiliser pour la légende du graphique. |
Renvois
ScatterChartBuilder
: 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 scatter chart with a 1-second animation duration. var builder = Charts.newScatterChart(); builder.setOption('animation.duration', 1000); var chart = builder.build();
Paramètres
Nom | Type | Description |
---|---|---|
option | String | L'option à définir. |
value | Object | Valeur à définir. |
Renvois
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
style | PointStyle | Style à utiliser pour les points de la ligne. |
Renvois
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
Voir aussi
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
Nom | Type | Description |
---|---|---|
chartTitle | String | le titre du graphique. |
Renvois
ScatterChartBuilder
: 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
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
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
setXAxisLogScale()
Transforme l'axe horizontal en une échelle logarithmique (toutes les valeurs doivent être positives).
Renvois
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
setXAxisRange(start, end)
Définit la plage correspondant à l'axe horizontal 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.
// 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
Nom | Type | Description |
---|---|---|
start | Number | Valeur de la ligne de grille la plus basse de l'axe horizontal. |
end | Number | Valeur de la ligne de grille la plus élevée de l'axe horizontal. |
Renvois
ScatterChartBuilder
: 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
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
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
title | String | Titre de l'axe des X. |
Renvois
ScatterChartBuilder
: 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
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
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
setYAxisLogScale()
Transforme l'axe vertical en une échelle logarithmique (toutes les valeurs doivent être positives).
Renvois
ScatterChartBuilder
: compilateur, utile pour les enchaînements.
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
Nom | Type | Description |
---|---|---|
start | Number | Valeur de la ligne de grille la plus basse de l'axe vertical. |
end | Number | Valeur de la ligne de grille la plus élevée de l'axe vertical. |
Renvois
ScatterChartBuilder
: 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
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
ScatterChartBuilder
: 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
Nom | Type | Description |
---|---|---|
title | String | Titre de l'axe Y. |
Renvois
ScatterChartBuilder
: 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
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
ScatterChartBuilder
: compilateur, utile pour les enchaînements.