Compilateur pour les graphiques à secteurs. Pour en savoir plus, consultez la documentation sur les graphiques Google.
Voici un exemple qui montre comment créer un graphique à secteurs. 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%3AB8' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1'; var chartBuilder = Charts.newPieChart() .setTitle('World Population by Continent') .setDimensions(600, 500) .set3D() .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | Chart | Crée le graphique. |
reverseCategories() | PieChartBuilder | Inverse le dessin de séries sur l'axe du domaine. |
set3D() | PieChartBuilder | Définit le graphique de sorte qu'il soit tridimensionnel. |
setBackgroundColor(cssValue) | PieChartBuilder | Définit la couleur d'arrière-plan du graphique. |
setColors(cssValues) | PieChartBuilder | Définit les couleurs des lignes du graphique. |
setDataSourceUrl(url) | PieChartBuilder | 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. |
setDataTable(tableBuilder) | PieChartBuilder | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
setDataTable(table) | PieChartBuilder | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
setDataViewDefinition(dataViewDefinition) | PieChartBuilder | Définit la définition de la vue des données à utiliser pour le graphique. |
setDimensions(width, height) | PieChartBuilder | Définit les dimensions du graphique. |
setLegendPosition(position) | PieChartBuilder | Définit la position de la légende par rapport au graphique. |
setLegendTextStyle(textStyle) | PieChartBuilder | Définit le style de texte de la légende du graphique. |
setOption(option, value) | PieChartBuilder | Définit les options avancées de ce graphique. |
setTitle(chartTitle) | PieChartBuilder | Définit le titre du graphique. |
setTitleTextStyle(textStyle) | PieChartBuilder | Définit le style de texte du titre du graphique. |
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.
reverseCategories()
Inverse le dessin de séries sur l'axe du domaine. 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 (tels que les graphiques à barres), cela signifie que l'axe vertical est dessiné de haut 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
PieChartBuilder
: compilateur utile pour les chaînes.
set3D()
Définit le graphique de sorte qu'il soit tridimensionnel.
Renvois
PieChartBuilder
: compilateur utile pour les chaînes.
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
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
cssValues | String[] | 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
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
url | String | URL de la source de données, y compris les paramètres de requête. |
Renvois
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
tableBuilder | DataTableBuilder | Gé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
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
table | DataTableSource | Tableau de données à utiliser pour le graphique. |
Renvois
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
dataViewDefinition | DataViewDefinition | Objet 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
PieChartBuilder
: compilateur utile pour les chaînes.
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
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
position | Position | Position de la légende. |
Renvois
PieChartBuilder
: 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
Nom | Type | Description |
---|---|---|
textStyle | TextStyle | Style de texte à utiliser pour la légende du graphique. |
Renvois
PieChartBuilder
: 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 pie chart with a pretty legend. var builder = Charts.newPieChart(); builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}}); var chart = builder.build();
Paramètres
Nom | Type | Description |
---|---|---|
option | String | Option à définir. |
value | Object | Valeur à définir. |
Renvois
PieChartBuilder
: compilateur utile pour les chaînes.
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
Nom | Type | Description |
---|---|---|
chartTitle | String | le titre du graphique. |
Renvois
PieChartBuilder
: 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
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
PieChartBuilder
: compilateur utile pour les chaînes.