Se usó la API de Cloud Translation para traducir esta página.

Class PieChartBuilder

Es un compilador de gráficos circulares. Para obtener más detalles, consulta la documentación de Gráficos de Google.

Este es un ejemplo que muestra cómo crear un gráfico circular. Los datos se importan desde una hoja de cálculo de 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();

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`build()`	`Chart`	Compila el gráfico.
`reverseCategories()`	`PieChartBuilder`	Revierte el dibujo de las series en el eje de dominio.
`set3D()`	`PieChartBuilder`	Establece que el gráfico sea tridimensional.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	Establece el color de fondo del gráfico.
`setColors(cssValues)`	`PieChartBuilder`	Establece los colores de las líneas del gráfico.
`setDataSourceUrl(url)`	`PieChartBuilder`	Establece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google.
`setDataTable(tableBuilder)`	`PieChartBuilder`	Establece la tabla de datos que se usará para el gráfico con un DataTableBuilder.
`setDataTable(table)`	`PieChartBuilder`	Establece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X.
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	Establece la definición de vista de datos que se usará para el gráfico.
`setDimensions(width, height)`	`PieChartBuilder`	Establece las dimensiones del gráfico.
`setLegendPosition(position)`	`PieChartBuilder`	Establece la posición de la leyenda con respecto al gráfico.
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	Establece el estilo de texto de la leyenda del gráfico.
`setOption(option, value)`	`PieChartBuilder`	Establece opciones avanzadas para este gráfico.
`setTitle(chartTitle)`	`PieChartBuilder`	Establece el título del gráfico.
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	Establece el estilo de texto del título del gráfico.

Documentación detallada

`build()`

Compila el gráfico.

Volver

Chart: Es un objeto Chart que se puede incorporar en documentos, elementos de la IU o usar como imagen estática.

`reverseCategories()`

Revierte el dibujo de las series en el eje de dominio. En el caso de los gráficos de rango vertical (como los gráficos de líneas, de áreas o de columnas), esto significa que el eje horizontal se dibuja de derecha a izquierda. En el caso de los gráficos de rango horizontal (como los gráficos de barras), esto significa que el eje vertical se dibuja de arriba abajo. En el caso de los gráficos circulares, esto significa que las porciones se dibujan en el sentido contrario a las manecillas del reloj.

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

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`set3D()`

Establece que el gráfico sea tridimensional.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setBackgroundColor(cssValue)`

Establece el color de fondo del gráfico.

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

Parámetros

Nombre	Tipo	Descripción
`cssValue`	`String`	Es el valor CSS del color (como `"blue"` o `"#00f"`).

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setColors(cssValues)`

Establece los colores de las líneas del gráfico.

// 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']);

Parámetros

Nombre	Tipo	Descripción
`cssValues`	`String[]`	Un array de valores de CSS de color, como `["red", "#acf"]`. El enésimo elemento del array representa el color de la enésima línea del gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setDataSourceUrl(url)`

Establece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google. Si se proporcionan una URL de fuente de datos y un DataTable, se ignora la URL de fuente de datos.

Para obtener más información sobre cómo consultar fuentes de datos, consulta la documentación de Gráficos de Google.

Parámetros

Nombre	Tipo	Descripción
`url`	`String`	La URL de la fuente de datos, incluidos los parámetros de consulta

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setDataTable(tableBuilder)`

Establece la tabla de datos que se usará para el gráfico con un DataTableBuilder. Este es un método conveniente para configurar la tabla de datos sin necesidad de llamar a build().

Parámetros

Nombre	Tipo	Descripción
`tableBuilder`	`DataTableBuilder`	Un creador de tablas de datos. Se crea una tabla de datos nueva de inmediato como parte de esta llamada, por lo que las actualizaciones adicionales del compilador no se reflejarán en el gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setDataTable(table)`

Establece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X. La primera columna debe ser una cadena y contener las etiquetas del eje horizontal. Se puede agregar cualquier cantidad de columnas, todas deben ser numéricas. Cada columna se muestra como una línea independiente.

Parámetros

Nombre	Tipo	Descripción
`table`	`DataTableSource`	Es la tabla de datos que se usará para el gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setDataViewDefinition(dataViewDefinition)`

Establece la definición de vista de datos que se usará para el gráfico.

Parámetros

Nombre	Tipo	Descripción
`dataViewDefinition`	`DataViewDefinition`	Es un objeto de definición de vista de datos que define la vista que se debe derivar de la fuente de datos determinada para el dibujo del gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setDimensions(width, height)`

Establece las dimensiones del gráfico.

Parámetros

Nombre	Tipo	Descripción
`width`	`Integer`	Es el ancho del gráfico, en píxeles.
`height`	`Integer`	Es la altura del gráfico, en píxeles.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setLegendPosition(position)`

Establece la posición de la leyenda con respecto al gráfico. De forma predeterminada, no hay leyenda.

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

Parámetros

Nombre	Tipo	Descripción
`position`	`Position`	Es la posición de la leyenda.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setLegendTextStyle(textStyle)`

Establece el estilo de texto de la leyenda del gráfico.

// 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);

Parámetros

Nombre	Tipo	Descripción
`textStyle`	`TextStyle`	Es el estilo de texto que se usará para la leyenda del gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setOption(option, value)`

Establece opciones avanzadas para este gráfico. Consulta las opciones disponibles para este gráfico. Este método no tiene efecto si la opción proporcionada no es válida.

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

Parámetros

Nombre	Tipo	Descripción
`option`	`String`	La opción que se debe configurar.
`value`	`Object`	El valor que se establecerá.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setTitle(chartTitle)`

Establece el título del gráfico. El título se muestra centrado sobre el gráfico.

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

Parámetros

Nombre	Tipo	Descripción
`chartTitle`	`String`	el título del gráfico.

Volver

PieChartBuilder: Este compilador es útil para encadenar.

`setTitleTextStyle(textStyle)`

Establece el estilo de texto del título del gráfico.

// 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);

Parámetros

Nombre	Tipo	Descripción
`textStyle`	`TextStyle`	Es el estilo de texto que se usará para el título del gráfico. Para crear un objeto `TextStyleBuilder`, llama a `Charts.newTextStyle()`.

Volver

PieChartBuilder: Este compilador es útil para encadenar.