Class PieChartBuilder

PieChartBuilder

Un compilador para gráficos circulares Para obtener más detalles, consulta la documentación de Google Charts.

En este ejemplo, se 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.
  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étodos

MétodoTipo de datos que se muestraDescripción breve
build()ChartCompila el gráfico.
reverseCategories()PieChartBuilderInvierte el dibujo de la serie en el eje del dominio.
set3D()PieChartBuilderEstablece el gráfico en tres dimensiones.
setBackgroundColor(cssValue)PieChartBuilderEstablece el color de fondo para el gráfico.
setColors(cssValues)PieChartBuilderEstablece los colores para las líneas en el gráfico.
setDataSourceUrl(url)PieChartBuilderEstablece 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)PieChartBuilderConfigura la tabla de datos que se usará para el gráfico con DataTableBuilder.
setDataTable(table)PieChartBuilderEstablece la tabla de datos que contiene las líneas del gráfico y las etiquetas del eje X.
setDataViewDefinition(dataViewDefinition)PieChartBuilderEstablece la definición de la vista de datos para usar en el gráfico.
setDimensions(width, height)PieChartBuilderEstablece las dimensiones del gráfico.
setLegendPosition(position)PieChartBuilderEstablece la posición de la leyenda con respecto al gráfico.
setLegendTextStyle(textStyle)PieChartBuilderEstablece el estilo de texto de la leyenda del gráfico.
setOption(option, value)PieChartBuilderEstablece opciones avanzadas para este gráfico.
setTitle(chartTitle)PieChartBuilderEstablece el título del gráfico.
setTitleTextStyle(textStyle)PieChartBuilderEstablece el estilo del texto del título del gráfico.

Documentación detallada

build()

Compila el gráfico.

Volver

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


reverseCategories()

Invierte el dibujo de la serie en el eje del dominio. Para los gráficos de rango vertical (como los gráficos de líneas, de área o de columnas), esto significa que el eje horizontal se dibuja de derecha a izquierda. Para 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 secciones se dibujan en sentido antihorario.

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

Volver

PieChartBuilder: Este compilador, útil para encadenar.


set3D()

Establece el gráfico en tres dimensiones.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setBackgroundColor(cssValue)

Establece el color de fondo para el gráfico.

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

Parámetros

NombreTipoDescripción
cssValueStringEl valor de CSS del color (como "blue" o "#00f")

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setColors(cssValues)

Establece los colores para las líneas en el gráfico.

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

Parámetros

NombreTipoDescripción
cssValuesString[]Un arreglo de valores CSS de color, como ["red", "#acf"]. El enésimo elemento del arreglo representa el color de la enésima línea del gráfico.

Volver

PieChartBuilder: Este compilador, ú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 una tabla de datos, se ignora la URL de fuente de datos.

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

Parámetros

NombreTipoDescripción
urlStringLa URL de la fuente de datos, incluidos los parámetros de búsqueda.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setDataTable(tableBuilder)

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

Parámetros

NombreTipoDescripción
tableBuilderDataTableBuilderUn compilador de tablas de datos Como parte de esta llamada, se crea una tabla de datos nueva de forma instantánea, por lo que las actualizaciones posteriores al compilador no se reflejarán en el gráfico.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setDataTable(table)

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

Parámetros

NombreTipoDescripción
tableDataTableSourceLa tabla de datos que se usará para el gráfico.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setDataViewDefinition(dataViewDefinition)

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

Parámetros

NombreTipoDescripción
dataViewDefinitionDataViewDefinitionUn objeto de definición de vista de datos que define la vista que debe derivar de la fuente de datos determinada para el dibujo del gráfico.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setDimensions(width, height)

Establece las dimensiones del gráfico.

Parámetros

NombreTipoDescripción
widthIntegerEs el ancho del gráfico en píxeles.
heightIntegerLa altura del gráfico en píxeles.

Volver

PieChartBuilder: Este compilador, ú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.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parámetros

NombreTipoDescripción
positionPositionLa posición de la leyenda

Volver

PieChartBuilder: Este compilador, ú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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parámetros

NombreTipoDescripción
textStyleTextStyleEl estilo de texto que se usará para la leyenda del gráfico.

Volver

PieChartBuilder: Este compilador, ú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 especificada no es válida.

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

Parámetros

NombreTipoDescripción
optionStringLa opción de establecer.
valueObjectValor que se va a establecer

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setTitle(chartTitle)

Establece el título del gráfico. El título se muestra en el centro del gráfico.

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

Parámetros

NombreTipoDescripción
chartTitleStringel título del gráfico.

Volver

PieChartBuilder: Este compilador, útil para encadenar.


setTitleTextStyle(textStyle)

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

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

Parámetros

NombreTipoDescripción
textStyleTextStyleEl estilo de texto que se usará para el título del gráfico. Puedes crear un objeto TextStyleBuilder llamando a Charts.newTextStyle().

Volver

PieChartBuilder: Este compilador, útil para encadenar.