visión general
un gráfico circular que se representa dentro del navegador mediante SVG o VML. Muestra información sobre herramientas al pasar el cursor sobre los sectores.,
Ejemplo
Hacer un Gráfico Circular 3D
Si se establece el is3D
opción true
, yourpie gráfico se dibuja como a pesar de que tiene tres dimensiones:
is3D
es false
por defecto, por lo que aquí se establezca explícitamente a true
:
Hacer un Donut Gráfico
Un donut gráfico es un gráfico circular con un agujero en el centro., Puede crear gráficos de donas con la opción pieHole
:
la opción pieHole
debe establecerse en un número entre 0 y 1, correspondiente a la relación de radios entre el agujero y el gráfico. Los números entre 0.4 y 0.6 se verán mejor en la mayoría de los gráficos.Los valores iguales o mayores que 1 serán ignorados, y un valor de 0 cerrará completamente su agujero de pastel.
no Se puede combinar el pieHole
y is3D
opciones; si lo hace, pieHole
será ignorado.,
tenga en cuenta que Google Charts intenta colocar la etiqueta lo más cerca posible del centro del segmento. Si tiene una tabla de donas con solo una rebanada, el Centro de la rebanada puede caer en el agujero de la dona. En ese caso, cambie el color de la etiqueta:
var options = { pieHole: 0.5, pieSliceTextStyle: { color: 'black', }, legend: 'none' };
girando un gráfico circular
de forma predeterminada, los gráficos circulares comienzan con el borde izquierdo de la primera sección apuntando directamente hacia arriba. Puede cambiar eso con la opción pieStartAngle
:
Aquí, giramos el gráfico en el sentido de las agujas del reloj 100 grados con una opción de pieStartAngle: 100
., (Así elegido porque ese particularangle pasa a hacer que la etiqueta» Italiano » encajar dentro de la rebanada.)
Exploding a Slice
puede separar sectores circulares del resto del gráfico con la propiedad offset
de la opción slices
:
para separar un sector, cree un objeto slices
y asigne número de corte apropiado an offset
entre 0 y 1., A continuación, asignamos compensaciones progresivamente más grandes a las rebanadas 4 (Gujarati), 12 (Marathi), 14 (Oriya) y 15 (Punjabi):
eliminar rebanadas
para omitir una rebanada, cambie el colorto 'transparent'
:
también usamos el pieStartAngle
para rotar el gráfico 135degrees, pieSliceText
para eliminar el texto de loslices, y tooltip.trigger
para deshabilitar la información sobre herramientas:
slice visibility threshold
puede establecer un valor como umbral para que un sector circular se procese individualmente., Este valor corresponde a una fracción del gráfico (siendo el gráfico entero de valor 1). Para establecer este umbral como un porcentaje del total, divida el porcentaje deseado por 100 (para un umbral del 20%, el valor sería 0.2).
sliceVisibilityThreshold: 5/8 // This is equivalent to 0.625 or 62.5% of the chart.
cualquier sector más pequeño que este umbral se combinará en un único sector «otro», y tendrá el valor combinado de todos los sectores por debajo del umbral.
Carga
El google.charts.load
nombre del paquete es de "corechart"
.,
google.charts.load("current", {packages: });
El nombre de clase de la visualización es google.visualization.PieChart
.
var visualization = new google.visualization.PieChart(container);
Formato de Datos
Filas: Cada fila de la tabla representa una rebanada.
columnas:
opciones de configuración
Name | |
---|---|
backgroundColor |
El color de fondo para el área principal del gráfico. Puede ser una simple cadena de color HTML, por ejemplo: Type: string or object
Default: ‘white’
|
backgroundColor.trazo |
El color del borde del gráfico, como una cadena de color HTML. Type: string
Default: ‘#666’
|
backgroundColor.strokeWidth |
El ancho del borde en píxeles. Type: number
Default: 0
|
backgroundColor.rellenar |
El color de relleno del gráfico, como una cadena de color HTML., Type: string
Default: ‘white’
|
chartArea |
un objeto con miembros para configurar la ubicación y el tamaño del área del gráfico (donde se dibuja el gráfico en sí, excluyendo ejes y leyendas). Se admiten dos formatos: un número o un número seguido de %. Un número simple es un valor en píxeles; un número seguido de % es un porcentaje. Ejemplo: Type: object
Default: null
|
chartArea.color de fondo |
color de fondo del área del gráfico., Cuando se usa una cadena, puede ser una cadena hexadecimal (por ejemplo, ‘#fdc’) o un nombre de color en inglés. Cuando se utiliza un objeto, se pueden proporcionar las siguientes propiedades:
Type: string or object
Default: ‘white’
|
chartArea.left |
hasta dónde dibujar el gráfico desde el borde izquierdo., Type: number or string
Default: auto
|
chartArea.top |
hasta dónde dibujar el gráfico desde el borde superior. Type: number or string
Default: auto
|
chartArea.ancho |
ancho del área del gráfico. Type: number or string
Default: auto
|
chartArea.altura |
altura del área del gráfico. Type: number or string
Default: auto
|
colors |
los colores a utilizar para los elementos del gráfico., Una matriz de cadenas, donde cada elemento es una cadena de color HTML, por ejemplo: Type: Array of strings
Default: default colors
|
enableInteractivity |
Si el gráfico lanza eventos basados en el usuario o reacciona a la interacción del usuario. Si es false, el gráfico no lanzará ‘select’ u otros eventos basados en interacción (pero lanzará eventos listos o de error), y no mostrará hovertext ni cambiará en función de la entrada del usuario., Type: boolean
Default: true
|
fontSize |
el tamaño de fuente predeterminado, en píxeles, de todo el texto del gráfico. Puede anular esto usando propiedades para elementos específicos del gráfico. Type: number
Default: automatic
|
fontName |
la cara de fuente predeterminada para todo el texto en el gráfico. Puede anular esto usando propiedades para elementos específicos del gráfico. Tipo: string
por Defecto: ‘Arial’
|
forceIFrame |
Dibuja el gráfico dentro de un marco en línea., (Tenga en cuenta que en IE8, esta opción se ignora; todos los gráficos IE8 se dibujan en I-frames.) Type: boolean
Default: false
|
height |
Height del gráfico, en píxeles. Type: number
Default: height of the containing element
|
is3D |
Si es true, muestra un gráfico tridimensional. Type: boolean
Default: false
|
legend |
un objeto con miembros para configurar varios aspectos de la leyenda., Para especificar las propiedades de este objeto, puede usar la notación literal del objeto, como se muestra aquí: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Type: object
Default: null
|
legend.alineación |
alineación de la leyenda. Puede ser una de las siguientes:
Start, center y end son relativos al estilo vertical vertical u horizontal.de la leyenda. Por ejemplo, en una leyenda ‘derecha’, ‘start’ y ‘end’ están en la parte superior e inferior, respectivamente; para una leyenda ‘top’, ‘start’ y ‘ end ‘ estarían a la izquierda y a la derecha del área, respectivamente. el valor predeterminado depende de la posición de la leyenda. Para Leyendas ‘bottom’, el valor predeterminado es’ center’; otras leyendas por defecto son’start’. Type: string
Default: automatic
|
legend.posición |
posición de la leyenda., Puede ser una de las siguientes:
Type: string
Default:’right’
|
legend.maxLines |
número Máximo de líneas en la leyenda. Establezca esto en un número mayor que uno para agregar líneas a su leyenda., Nota: la lógica exacta utilizada para determinar el número real de líneas renderizadas todavía está en flujo. esta opción actualmente solo funciona cuando legend.la posición es ‘top’. Type: number
Default: 1
|
legend.textStyle |
un objeto que especifica el estilo de texto de la leyenda. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } El Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieHole |
Si está entre 0 y 1, muestra un gráfico de rosquillas. El agujero con tiene un radio igual a Tipo: número
por Defecto: 0
|
pieSliceBorderColor |
El color de la rebanada de las fronteras. Solo aplicable cuando el gráfico es bidimensional., Type: string
Default: ‘white’
|
pieSliceText |
el contenido del texto que se muestra en el segmento. Puede ser uno de los siguientes:
Type: string
Default: ‘percentage’
|
pieSliceTextStyle |
un objeto que especifica el estilo de texto slice., El objeto tiene este formato: {color: <string>, fontName: <string>, fontSize: <number>} El Tipo: objeto
por Defecto:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
pieStartAngle |
El ángulo, en grados, para girar el gráfico. El valor predeterminado de Type: number
Default:
0 |
reverseCategories |
Si es true, dibuja rebanadas en sentido contrario a las agujas del reloj. El valor predeterminado es dibujar en el sentido de las agujas del reloj. Type: boolean
Default: false
|
pieResidueSliceColor |
Color para el segmento de combinación que contiene todos los segmentos debajo de sliceVisibilityThreshold., Type: string
Default: ‘#ccc’
|
pieResidueSliceLabel |
una Etiqueta para el segmento de combinación que contiene todos los segmentos debajo de sliceVisibilityThreshold. Type: string
Default: ‘Other’
|
slices |
una matriz de objetos, cada uno describiendo el formato del segmento correspondiente en el pastel. Para usar valores predeterminados para un sector, especifique un objeto vacío (es decir,
puede especificar una matriz de objetos, cada uno de los cuales se aplica al segmento en el orden dado, o puede especificar un objeto donde cada hijo tiene una clave numérica que indica a qué segmento se aplica. Por ejemplo, las siguientes dos declaraciones son idénticas, y declaran el primer segmento como Negro y el cuarto como Rojo: slices: slices: {0: {color: 'black'}, 3: {color: 'red'}} Type: Array of objects, or object with anided objects
Default: {}
|
slicevisibilitythreshold |
el valor fraccionario del pastel, a continuación que una rebanada no se mostrará individualmente., Todas las rebanadas que no hayan pasado este umbral se combinarán en una sola rebanada «otra», cuyo tamaño es la suma de todos sus tamaños. El valor predeterminado es no mostrar individualmente cualquier corte que sea menor que medio grado. // Slices less than 25% of the pie will be// combined into an "Other" slice.sliceVisibilityThreshold: .25 Type: number
Default: Half a degree (.5/360 o 1/720 o .0014)
|
title |
Text to display above the chart. Type: string
Default: no title
|
titleTextStyle |
un objeto que especifica el estilo de texto del título., The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip |
An object with members to configure various tooltip elements., Para especificar las propiedades de este objeto, puede usar la notación literal del objeto, como se muestra aquí: {textStyle: {color: '#FF0000'}, showColorCode: true} Type: object
Default: null
|
tooltip.ignoreBounds |
Si se establece en Nota: Esto solo se aplica a las sugerencias de Herramientas HTML. Si esto está habilitado con información sobre herramientas SVG, cualquier desbordamiento fuera de los límites del gráfico se recortará. Consulte Personalizar el contenido de la información sobre herramientas para obtener más detalles., Type: boolean
Default: false
|
tooltip.isHtml |
Si se establece en true, utilice información emergente HTML (en lugar de SVG-rendered). Consulte Personalizar el contenido de la información sobre herramientas para obtener más detalles. Nota: la visualización del gráfico de burbujas no admite la personalización del contenido de la información de Herramientas HTML a través del rol de datos de la columna de información de herramientas. Type: boolean
Default: false
|
tooltip.showColorCode |
si es true, muestra los cuadrados de color junto a la información del segmento en la información sobre herramientas., Type: boolean
Default: false
|
tooltip.text |
Qué información Mostrar cuando el usuario pasa el cursor sobre un trozo de pastel. Se admiten los siguientes valores:
Type: string
Default: ‘both’
|
tooltip.,textStyle |
An object that specifies the tooltip text style. The object has this format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> } The Type: object
Default:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>} |
tooltip.,trigger |
la interacción del usuario que hace que se muestre la información sobre herramientas:
Type: string
Default: ‘focus’
|
width |
Width del gráfico, en píxeles., Tipo: número
por Defecto: la anchura del elemento de contención
|
Métodos
Método | |
---|---|
draw(data, options) |
Dibuja el gráfico. El gráfico Acepta más llamadas a métodos solo después de que se active el evento Tipo devuelto: ninguno
|
getAction(actionID) |
Devuelve la descripción objeto de la acción con la solicitada Return Type: object
|
getBoundingBox(id) |
devuelve un objeto que contiene el elemento izquierdo, superior, ancho y alto del gráfico
los Valores son relativos al contenedor de la tabla. Llame a esto después de que se dibuje el gráfico. Return Type: object
|
getChartAreaBoundingBox()
|
devuelve un objeto que contiene la izquierda, la parte superior, el ancho y la altura del contenido del gráfico (P.,, con exclusión de las etiquetas y de la leyenda):
Los valores son relativos al contenedor de la tabla. Llame a esto después de que se dibuje el gráfico. Return Type: object
|
getChartLayoutInterface() |
devuelve un objeto que contiene información sobre la colocación en pantalla del gráfico y sus elementos., Los siguientes métodos pueden ser llamados en el objeto devuelto:
Llame a esto después de que el gráfico se dibuja. Return Type: object
|
getHAxisValue(position, optional_axis_index) |
devuelve el valor horizontal lógico en Ejemplo: llame a esto después de dibujar el gráfico. Return Type: number
|
getImageURI() |
devuelve el gráfico serializado como un URI de imagen. llame a esto después de dibujar el gráfico. consulte Impresión de gráficos PNG. Tipo devuelto: string
|
getSelection() |
Devuelve un array con el gráfico seleccionado entidades. Las entidades seleccionables son secciones y entradas de leyenda. Para este gráfico, solo se puede seleccionar una entidad en un momento dado., Return Type: Array of selection elements
|
getVAxisValue(position, optional_axis_index) |
devuelve el valor vertical lógico en Ejemplo: llame a esto después de dibujar el gráfico. Return Type: number
|
getXLocation(position, optional_axis_index) |
devuelve la coordenada X de pantalla de Ejemplo: llame a esto después de dibujar el gráfico. Return Type: number
|
getYLocation(position, optional_axis_index) |
devuelve la coordenada y de pantalla de Ejemplo: llame a esto después de dibujar el gráfico. Tipo devuelto: número
|
removeAction(actionID) |
Elimina la descripción de la acción con la solicitada Return Type:
none |
setAction(action) |
establece una acción de información sobre herramientas que se ejecutará cuando el Usuario haga clic en el texto de la acción. el método todas y cada una de las acciones de información sobre herramientas deben configurarse antes de llamar al método Tipo de Devolución:
none |
setSelection() |
se Selecciona el gráfico especificado entidades. Cancela cualquier selección previa. Las entidades seleccionables son secciones y entradas de leyenda. Para este gráfico, solo se puede seleccionar una entidad a la vez. Tipo devuelto: ninguno
|
clearChart() |
Borra el gráfico, y libera todos sus recursos asignados. Return Type: none
|
Events
para obtener más información sobre cómo usar estos eventos, consulte interactividad básica, Manejo de eventos y activación de eventos.
Nombre | |
---|---|
click |
se activa cuando el usuario hace clic dentro de la tabla., Se puede usar para identificar cuándo se hace clic en el título, los elementos de datos, las entradas de leyenda, los ejes, las líneas de cuadrícula o las etiquetas. Propiedades: targetID
|
error |
se activa cuando se produce un error al intentar representar el gráfico. Propiedades: id, mensaje
|
onmouseover |
se activa cuando el usuario coloca el ratón sobre una entidad visual. Devuelve los índices de fila y columna del elemento de tabla de datos correspondiente. Una entrada de segmento o leyenda se correlaciona con una fila en la tabla de datos (el índice de columna es nulo)., Properties: row, column
|
onmouseout
|
Fired when the user mouses away from a visual entity. Devuelve los índices de fila y columna del elemento de tabla de datos correspondiente. Una entrada de segmento o leyenda se correlaciona con una fila en la tabla de datos (el índice de columna es nulo). Properties: row, column
|
ready
|
el gráfico está listo para llamadas a métodos externos., Si desea interactuar con el gráfico y llamar a los métodos después de dibujarlo, debe configurar un receptor para este evento antes de llamar al método Propiedades: ninguno
|
select |
se activa cuando el usuario hace clic en una entidad visual. Para saber qué se ha seleccionado, llame a Properties: none
|
Data Policy
todo el código y los datos se procesan y representan en el navegador., No se envían datos a ningún servidor.