饼图生成工具。如需了解详情,请参阅 Google 图表文档。
以下示例展示了如何构建饼图。数据是从 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();
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | Chart | 构建图表。 |
reverseCategories() | PieChartBuilder | 反转域轴上的序列绘制。 |
set3D() | PieChartBuilder | 将图表设置为三维。 |
setBackgroundColor(cssValue) | PieChartBuilder | 设置图表的背景颜色。 |
setColors(cssValues) | PieChartBuilder | 设置图表中线条的颜色。 |
setDataSourceUrl(url) | PieChartBuilder | 设置数据源网址,用于从外部来源(如 Google 表格)拉取数据。 |
setDataTable(tableBuilder) | PieChartBuilder | 使用 DataTableBuilder 设置要用于图表的数据表。 |
setDataTable(table) | PieChartBuilder | 设置数据表,其中包含图表的线条以及 X 轴标签。 |
setDataViewDefinition(dataViewDefinition) | PieChartBuilder | 设置要用于图表的数据视图定义。 |
setDimensions(width, height) | PieChartBuilder | 设置图表的尺寸。 |
setLegendPosition(position) | PieChartBuilder | 设置图例相对于图表的位置。 |
setLegendTextStyle(textStyle) | PieChartBuilder | 设置图表图例的文本样式。 |
setOption(option, value) | PieChartBuilder | 设置此图表的高级选项。 |
setTitle(chartTitle) | PieChartBuilder | 设置图表的标题。 |
setTitleTextStyle(textStyle) | PieChartBuilder | 设置图表标题的文本样式。 |
详细文档
build()
reverseCategories()
反转域轴上的序列绘制。对于垂直范围图表(例如折线图、面积图或柱形图),这意味着横轴从右向左绘制。对于水平范围图表(例如条形图),这意味着纵轴从上到下绘制。对于饼图,这意味着各切片按逆时针方向绘制。
// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner. var builder = Charts.newPieChart(); builder.reverseCategories();
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
set3D()
setBackgroundColor(cssValue)
设置图表的背景颜色。
// Creates a line chart builder and sets the background color to gray var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
参数
名称 | 类型 | 说明 |
---|---|---|
cssValue | String | 颜色的 CSS 值(例如 "blue" 或 "#00f" )。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setColors(cssValues)
设置图表中线条的颜色。
// 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"]);
参数
名称 | 类型 | 说明 |
---|---|---|
cssValues | String[] | 颜色 CSS 值数组,例如 ["red", "#acf"] 。数组中的第 n 个元素表示图表中第 n 条线的颜色。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setDataSourceUrl(url)
设置数据源网址,用于从外部来源(如 Google 表格)拉取数据。如果提供了数据源网址和 DataTable,系统会忽略数据源网址。
如需详细了解如何查询数据源,请参阅 Google 图表文档。
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据源网址,包括任何查询参数。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setDataTable(tableBuilder)
使用 DataTableBuilder 设置要用于图表的数据表。这是一种无需调用 build()
即可设置数据表的便捷方法。
参数
名称 | 类型 | 说明 |
---|---|---|
tableBuilder | DataTableBuilder | 数据表构建器。在此调用中,系统会立即创建新的数据表,因此对构建器的任何后续更新都不会反映在图表中。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setDataTable(table)
设置数据表,其中包含图表的线条以及 X 轴标签。第一列应为字符串,并包含横轴标签。后面可跟随任意数量的列,且所有列都必须是数字。每一列都显示为单独的一行。
参数
名称 | 类型 | 说明 |
---|---|---|
table | DataTableSource | 要用于图表的数据表。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setDataViewDefinition(dataViewDefinition)
设置要用于图表的数据视图定义。
参数
名称 | 类型 | 说明 |
---|---|---|
dataViewDefinition | DataViewDefinition | 一个数据视图定义对象,用于定义应从图表绘图的给定数据源派生的视图。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setDimensions(width, height)
设置图表的尺寸。
参数
名称 | 类型 | 说明 |
---|---|---|
width | Integer | 图表的宽度(以像素为单位)。 |
height | Integer | 图表的高度(以像素为单位)。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setLegendPosition(position)
设置图例相对于图表的位置。默认情况下,不显示图例。
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
参数
名称 | 类型 | 说明 |
---|---|---|
position | Position | 图例的位置。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setLegendTextStyle(textStyle)
设置图表图例的文本样式。
// 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);
参数
名称 | 类型 | 说明 |
---|---|---|
textStyle | TextStyle | 用于图表图例的文本样式。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setOption(option, value)
设置此图表的高级选项。请参阅此图表的可用选项。如果指定的选项无效,此方法不会产生任何影响。
// Build a pie chart with a pretty legend. var builder = Charts.newPieChart(); builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}}); var chart = builder.build();
参数
名称 | 类型 | 说明 |
---|---|---|
option | String | 要设置的选项。 |
value | Object | 要设置的值。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setTitle(chartTitle)
设置图表的标题。标题会显示在图表上方的中心位置。
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
参数
名称 | 类型 | 说明 |
---|---|---|
chartTitle | String | 图表标题。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。
setTitleTextStyle(textStyle)
设置图表标题的文本样式。
// 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);
参数
名称 | 类型 | 说明 |
---|---|---|
textStyle | TextStyle | 用于图表标题的文本样式。您可以通过调用 Charts.newTextStyle() 来创建 TextStyleBuilder 对象。 |
弃踢回攻
PieChartBuilder
- 此构建器,可用于链接。