Class PieChartBuilder

饼图构建器

饼图的构建器。如需了解详情，请参阅 Google 图表文档。

以下示例展示了如何构建饼图。数据是从 Google 电子表格导入的。 

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

const chartBuilder = Charts.newPieChart()
                         .setTitle('World Population by Continent')
                         .setDimensions(600, 500)
                         .set3D()
                         .setDataSourceUrl(dataSourceUrl);

const 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()

构建图表。

返回

Chart - 图表对象，可嵌入到文档、界面元素中，或用作静态图片。

reverseCategories()

反转在领域轴中绘制系列的方式。对于垂直范围图表（例如折线图、面积图或柱形图），这意味着水平轴是从右到左绘制的。对于水平范围图表（例如条形图），这意味着垂直轴是从上到下绘制的。对于饼图，这意味着饼状块是逆时针绘制的。 

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

返回

PieChartBuilder - 此构建器适用于链接。

set3D()

将图表设为三维图表。

返回

PieChartBuilder - 此构建器适用于链接。

setBackgroundColor(cssValue)

设置图表的背景颜色。 

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

参数

名称类型说明
cssValueString颜色的 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.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

参数

名称类型说明
cssValuesString[]颜色 CSS 值数组，例如 ["red", "#acf"]。数组中的第 n 个元素表示图表中第 n 条线的颜色。

返回

PieChartBuilder - 此构建器适用于链接。

setDataSourceUrl(url)

设置用于从外部来源（例如 Google 表格）提取数据的数据源网址。如果同时提供了数据源网址和 DataTable，系统会忽略数据源网址。

如需详细了解如何查询数据源，请参阅 Google 图表文档。

参数

名称类型说明
urlString数据源网址，包括所有查询参数。

返回

PieChartBuilder - 此构建器适用于链接。

setDataTable(tableBuilder)

使用 DataTableBuilder 设置要用于图表的数据表。这是一个便捷方法，可用于设置数据表，而无需调用 build()。

参数

名称类型说明
tableBuilderDataTableBuilder数据表构建器。在此调用过程中，系统会立即创建一个新的数据表格，因此对构建器的任何进一步更新都不会反映在图表中。

返回

PieChartBuilder - 此构建器适用于链接。

setDataTable(table)

设置包含图表线条和 X 轴标签的数据表。第一列应为字符串，并包含水平轴标签。后面可以跟任意数量的列，所有列都必须是数字。每个列都会显示为单独的一行。

参数

名称类型说明
tableDataTableSource要用于图表的数据表。

返回

PieChartBuilder - 此构建器适用于链接。

setDataViewDefinition(dataViewDefinition)

设置要用于图表的数据视图定义。

参数

名称类型说明
dataViewDefinitionDataViewDefinition数据视图定义对象，用于定义应从给定数据源派生以用于图表绘制的视图。

返回

PieChartBuilder - 此构建器适用于链接。

setDimensions(width, height)

设置图表的尺寸。

参数

名称类型说明
widthInteger图表的宽度（以像素为单位）。
heightInteger图表的高度（以像素为单位）。

返回

PieChartBuilder - 此构建器适用于链接。

setLegendPosition(position)

设置图例相对于图表的位置。默认情况下，没有图例。 

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

参数

名称类型说明
positionPosition图例的位置。

返回

PieChartBuilder - 此构建器适用于链接。

setLegendTextStyle(textStyle)

设置图表图例的文本样式。 

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

参数

名称类型说明
textStyleTextStyle要为图表图例使用的文本样式。

返回

PieChartBuilder - 此构建器适用于链接。

setOption(option, value)

设置此图表的高级选项。请参阅此图表的可用选项。如果指定的选项无效，此方法将不会产生任何影响。 

// Build a pie chart with a pretty legend.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

参数

名称类型说明
optionString要设置的选项。
valueObject要设置的值。

返回

PieChartBuilder - 此构建器适用于链接。

setTitle(chartTitle)

设置图表的标题。标题会居中显示在图表上方。 

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

参数

名称类型说明
chartTitleString图表标题。

返回

PieChartBuilder - 此构建器适用于链接。

setTitleTextStyle(textStyle)

设置图表标题的文本样式。 

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

参数

名称类型说明
textStyleTextStyle要为图表标题使用的文本样式。您可以通过调用 Charts.newTextStyle() 来创建 TextStyleBuilder 对象。

返回

PieChartBuilder - 此构建器适用于链接。