Un compilador para gráficos circulares. Para obtener más detalles, consulta la documentación de Google Charts.
A continuación, te mostramos un ejemplo de 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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
build() | Chart | Crea el gráfico. |
reverseCategories() | PieChartBuilder | Invierte el dibujo de una serie en el eje del dominio. |
set3D() | PieChartBuilder | Configura el gráfico para que sea tridimensional. |
setBackgroundColor(cssValue) | PieChartBuilder | Establece el color de fondo del gráfico. |
setColors(cssValues) | PieChartBuilder | Establece los colores para las líneas del gráfico. |
setDataSourceUrl(url) | PieChartBuilder | Configura 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 mediante 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 para el 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 las 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()
Crea el gráfico.
Devolvedor
Chart
: Es un objeto de gráfico que se puede incorporar en documentos y elementos de la IU, o que se puede usar como imagen estática.
reverseCategories()
Invierte el dibujo de una serie en el eje del dominio. Para los gráficos de rango vertical (como los gráficos de líneas, áreas o 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. Para los gráficos circulares, esto significa que las porciones 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();
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
set3D()
Configura el gráfico para que sea tridimensional.
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setBackgroundColor(cssValue)
Establece el color de fondo del gráfico.
// Creates a line chart builder and sets the background color to gray var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
cssValue | String | Es el valor de CSS para el color (como "blue" o "#00f" ). |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setColors(cssValues)
Establece los colores para 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. var 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. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setDataSourceUrl(url)
Configura 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 DataTable, se ignora la URL de la fuente de datos.
Si deseas obtener más información para consultar fuentes de datos, lee la documentación de Gráficos de Google.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
url | String | Es la URL de la fuente de datos, incluidos los parámetros de consulta. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setDataTable(tableBuilder)
Establece la tabla de datos que se usará para el gráfico mediante 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 Como parte de esta llamada, se crea de forma instantánea una nueva tabla de datos, por lo que las actualizaciones posteriores del compilador no se reflejarán en el gráfico. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
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 string y contener las etiquetas del eje horizontal. Cualquier cantidad de columnas puede estar seguida, todas deben ser numéricas. Cada columna se muestra como una línea separada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
table | DataTableSource | La tabla de datos que se usará para el gráfico. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
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. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setDimensions(width, height)
Establece las dimensiones para el gráfico.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
width | Integer | Indica el ancho del gráfico en píxeles. |
height | Integer | Indica la altura del gráfico en píxeles. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
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
Nombre | Tipo | Descripción |
---|---|---|
position | Position | La posición de la leyenda. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
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
Nombre | Tipo | Descripción |
---|---|---|
textStyle | TextStyle | El estilo de texto que se utilizará para la leyenda del gráfico. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setOption(option, value)
Establece las 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. var builder = Charts.newPieChart(); builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}}); var chart = builder.build();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
option | String | La opción de configurar. |
value | Object | El valor que se establecerá. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
setTitle(chartTitle)
Establece el título del gráfico. El título se muestra centrado encima 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
Nombre | Tipo | Descripción |
---|---|---|
chartTitle | String | el título del gráfico. |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.
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. var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); var style = textStyleBuilder.build(); var builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
textStyle | TextStyle | El estilo de texto que se utilizará para el título del gráfico. Puedes crear un objeto TextStyleBuilder llamando a Charts.newTextStyle() . |
Devolvedor
PieChartBuilder
: Este compilador es útil para el encadenamiento.