Descripción general
Un histograma es un gráfico que agrupa datos numéricos en discretizaciones y muestra las discretizaciones como columnas segmentadas. Se usan para representar la distribución de un conjunto de datos: la frecuencia con la que los valores caen dentro de rangos.
Gráficos de Google elige automáticamente el número de discretizaciones por ti. Todos los discretizaciones tienen el mismo ancho y una altura proporcional a la cantidad de datos de la discretización. En otros aspectos, los histogramas son similares a los gráficos de columnas.
Ejemplo
Aquí hay un histograma de la longitud de los dinosaurios:
El histograma nos indica que el discretización más común es inferior a 10 metros, y que solo hay un dinosaurio por encima de los 40 metros. Podemos colocar el cursor sobre la barra y descubrir que se trata del Seismosaurus (que podría ser un Diplodocus muy grande; los paleontólogos no lo saben bien).
El código para generar este histograma se muestra a continuación. Después de definir los datos (aquí, con google.visualization.arrayToDataTable
), el gráfico se define con una llamada a google.visualization.Histogram
y se dibuja con el método draw
.
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:["corechart"]}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Dinosaur', 'Length'], ['Acrocanthosaurus (top-spined lizard)', 12.2], ['Albertosaurus (Alberta lizard)', 9.1], ['Allosaurus (other lizard)', 12.2], ['Apatosaurus (deceptive lizard)', 22.9], ['Archaeopteryx (ancient wing)', 0.9], ['Argentinosaurus (Argentina lizard)', 36.6], ['Baryonyx (heavy claws)', 9.1], ['Brachiosaurus (arm lizard)', 30.5], ['Ceratosaurus (horned lizard)', 6.1], ['Coelophysis (hollow form)', 2.7], ['Compsognathus (elegant jaw)', 0.9], ['Deinonychus (terrible claw)', 2.7], ['Diplodocus (double beam)', 27.1], ['Dromicelomimus (emu mimic)', 3.4], ['Gallimimus (fowl mimic)', 5.5], ['Mamenchisaurus (Mamenchi lizard)', 21.0], ['Megalosaurus (big lizard)', 7.9], ['Microvenator (small hunter)', 1.2], ['Ornithomimus (bird mimic)', 4.6], ['Oviraptor (egg robber)', 1.5], ['Plateosaurus (flat lizard)', 7.9], ['Sauronithoides (narrow-clawed lizard)', 2.0], ['Seismosaurus (tremor lizard)', 45.7], ['Spinosaurus (spiny lizard)', 12.2], ['Supersaurus (super lizard)', 30.5], ['Tyrannosaurus (tyrant lizard)', 15.2], ['Ultrasaurus (ultra lizard)', 30.5], ['Velociraptor (swift robber)', 1.8]]); var options = { title: 'Lengths of dinosaurs, in meters', legend: { position: 'none' }, }; var chart = new google.visualization.Histogram(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <div id="chart_div" style="width: 900px; height: 500px;"></div> </body> </html>
Las etiquetas (en este caso, los nombres de los dinosaurios) se pueden omitir. En ese caso, la información sobre la herramienta mostrará solo el valor numérico.
Control de colores
Aquí hay un histograma de poblaciones nacionales:
Más de 200 países tienen poblaciones de menos de cien millones y una disminución severa después de eso.
En este histograma, se usa la opción colors
para dibujar los datos en verde:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['green'], };
Al igual que con todos los gráficos de Google, los colores se pueden especificar como nombres en inglés o como valores hexadecimales.
Control de buckets
De forma predeterminada, Google Charts elegirá el tamaño del bucket de forma automática mediante un algoritmo conocido para histogramas. Sin embargo, a veces querrás anular eso, y el gráfico de arriba es un ejemplo. Con tantos países en el primer intervalo, es difícil examinarlos en otros.
Para situaciones como esta, el gráfico de histograma proporciona dos opciones: histogram.bucketSize
, que anula el algoritmo y codifica el tamaño del bucket, y histogram.lastBucketPercentile
. La segunda opción necesita más explicación: cambia el cálculo de los tamaños de los buckets para ignorar los valores superiores o inferiores a los valores restantes según el porcentaje que especifiques. Los valores siguen incluidos en el histograma, pero no afectan la forma en que se agrupan. Esto es útil cuando no quieres que los valores atípicos lleguen a sus propios buckets; en su lugar, se agruparán con el primero o el último bucket.
En el gráfico anterior, ignoramos el cinco por ciento superior y el cinco por ciento inferior al calcular el tamaño del bucket. Los valores aún se representan en gráficos. Lo único que cambió es el tamaño del bucket, pero genera un histograma más legible.
En este ejemplo, también se muestra cómo podemos cambiar la escala del eje vertical para usar la escala de “registro duplicado”, lo que también ayuda a la hora de graficar datos que tienen una cola larga de valores pequeños.
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { lastBucketPercentile: 5 }, vAxis: { scaleType: 'mirrorLog' } };
Como puedes ver, quitar el cinco por ciento superior e inferior del cálculo dio como resultado un tamaño de bucket de 10,000,000, en lugar de los 100,000,000 de lo contrario. Si todo el tiempo supieras que lo que querías era un tamaño de bucket de 10,000,000, podrías haber usado histogram.bucketSize
para hacerlo:
var options = { title: 'Country Populations', legend: { position: 'none' }, colors: ['#e7711c'], histogram: { bucketSize: 10000000 } };
En el siguiente ejemplo, se muestra cómo expandir el rango de los buckets y mostrar muchos más buckets sin espacios entre ellos. La opción maxNumBuckets
se puede usar para aumentar la cantidad predeterminada de buckets. Las opciones histogram.minValue
y histogram.maxValue
expandirán el rango de los buckets, pero ten en cuenta que si hay datos fuera de este rango, estas opciones no lo reducirán.
En este ejemplo, también se muestra que puedes especificar las marcas que se mostrarán en cada uno de los buckets con la opción explícita ticks
para hAxis
. Esto no afecta a los buckets en sí, sino solo a la forma en que se muestran las marcas.
Además, ten en cuenta que especificamos chartArea.width
de modo que la cantidad de buckets se ajuste con mayor precisión sin artefactos visuales. Estas son las opciones para este ejemplo.
var options = { title: 'Approximating Normal Distribution', legend: { position: 'none' }, colors: ['#4285F4'], chartArea: { width: 405 }, hAxis: { ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1] }, bar: { gap: 0 }, histogram: { bucketSize: 0.01, maxNumBuckets: 400, minValue: -1, maxValue: 1 } };
Varias series
A continuación, se muestra un histograma de las cargas de partículas subatómicas, según el modelo estándar:
El gráfico anterior tiene una serie que contiene todas las partículas. Las partículas subatómicas se pueden dividir en cuatro grupos: quarks, leptones y bosones. Tratemos cada una como su propia serie:
En este gráfico, usamos una serie diferente (y, por lo tanto, color) para cada uno de los cuatro tipos de partículas subatómicas. Establecemos de forma explícita interpolateNulls
en false
para garantizar que no se trazan los valores nulos (necesarios porque las series tienen una longitud desigual). También configuramos legend.maxLines
para agregar otra línea a la leyenda:
var data = google.visualization.arrayToDataTable([ ['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'], [2/3, -1, 0, 0], [2/3, -1, 0, null], [2/3, -1, 0, null], [-1/3, 0, 1, null], [-1/3, 0, -1, null], [-1/3, 0, null, null], [-1/3, 0, null, null] ]); var options = { title: 'Charges of subatomic particles', legend: { position: 'top', maxLines: 2 }, colors: ['#5C3292', '#1A8763', '#871B47', '#999999'], interpolateNulls: false, };
Cargando
El nombre del paquete google.charts.load
es "corechart"
.
google.charts.load("current", {packages: ["corechart"]});
El nombre de clase de la visualización es google.visualization.Histogram
:
var visualization = new google.visualization.Histogram(container);
Formato de datos
Hay dos formas de completar una tabla de datos de histograma. Cuando solo hay una serie:
var data = google.visualization.arrayToDataTable([ ['Name', 'Number'], ['Name 1', number1], ['Name 2', number2], ['Name 3', number3], ... ]);
...y cuando hay varias series:
var data = google.visualization.arrayToDataTable([ ['Series Name 1', 'Series Name 2', 'Series Name 3', ...], [series1_number1, series2_number1, series3_number1, ...], [series1_number2, series2_number2, series3_number2, ...], [series1_number3, series2_number3, series3_number3, ...], ... ]);
En este momento, no se admiten roles de columna opcionales para los histogramas.
Opciones de configuración
Nombre | |
---|---|
animation.duration |
Es la duración de la animación en milisegundos. Para obtener más detalles, consulta la documentación sobre animaciones. Tipo: Número
Valor predeterminado: 0
|
animation.easing |
Es la función de aceleración aplicada a la animación. Están disponibles las siguientes opciones:
Tipo: string
Predeterminado: "lineal"
|
animation.startup |
Determina si se animará el gráfico en el dibujo inicial. Si es Tipo: booleano
Predeterminado falso
|
axisTitlesPosition |
Es el lugar en el que se colocan los títulos de los ejes en comparación con el área del gráfico. Valores admitidos:
Tipo: string
Configuración predeterminada: "out"
|
backgroundColor |
El color de fondo del área principal del gráfico. Puede ser una cadena simple de color HTML, por ejemplo: Tipo: objeto o cadena
Predeterminado: “white”
|
backgroundColor.stroke |
El color del borde del gráfico, como una cadena de color HTML. Tipo: string
Predeterminado: “#666”
|
backgroundColor.strokeWidth |
Es el ancho del borde en píxeles. Tipo: Número
Valor predeterminado: 0
|
backgroundColor.fill |
El color de relleno del gráfico, como una cadena HTML de color. Tipo: string
Predeterminado: “white”
|
bar.groupWidth |
Ancho de un grupo de barras, especificado en cualquiera de estos formatos:
Tipo: número o string
Valor predeterminado: Proporción de oro, aproximadamente "61.8%".
|
chartArea |
Un objeto con miembros para configurar la posición y el tamaño del área del gráfico (donde se dibuja el gráfico, sin incluir los ejes ni las 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: Tipo: objeto
Valor predeterminado: nulo
|
chartArea.backgroundColor |
Color de fondo del área del gráfico Cuando se usa una cadena, puede ser una cadena hexadecimal (p.ej., “#fdc”) o un nombre de color en inglés. Cuando se usa un objeto, se pueden proporcionar las siguientes propiedades:
Tipo: objeto o cadena
Predeterminado: “white”
|
chartArea.left |
Indica qué tan lejos se debe dibujar el gráfico desde el borde izquierdo. Tipo: número o string
Predeterminada: automática
|
chartArea.top |
Indica qué tan lejos se debe dibujar el gráfico desde el borde superior. Tipo: número o string
Predeterminada: automática
|
chartArea.width |
Ancho del área del gráfico. Tipo: número o string
Predeterminada: automática
|
chartArea.height |
Altura del área del gráfico. Tipo: número o string
Predeterminada: automática
|
colores |
Los colores que se usarán para los elementos del gráfico. Un array de cadenas, en el que cada elemento es una cadena de color HTML, por ejemplo: Tipo: Arreglo de cadenas
Predeterminado: Colores predeterminados
|
dataOpacity |
La transparencia de los datos, en la que 1.0 es completamente opaco y 0.0 completamente transparente. En los gráficos de dispersión, histogramas, de barras y columnas, se refiere a los datos visibles: puntos en el diagrama de dispersión y rectángulos en los demás. En los gráficos en los que al seleccionar datos se crea un punto, como los gráficos de líneas y de áreas, esto hace referencia a los círculos que aparecen cuando se coloca el cursor sobre un elemento o se lo selecciona. El gráfico combinado muestra ambos comportamientos, y esta opción no tiene efecto en otros gráficos. (Para cambiar la opacidad de una línea de tendencia, consulta Opacidad de la línea de tendencia ). Tipo: Número
Predeterminado: 1.0
|
enableInteractivity |
Si el gráfico arroja eventos basados en el usuario o reacciona a la interacción del usuario. Si es falso, el gráfico no arrojará "seleccionar" ni otros eventos basados en interacciones (pero sí arrojará eventos listos o de error), ni mostrará texto flotante ni cambiará según la entrada del usuario. Tipo: booleano
Predeterminado: verdadero
|
focusTarget |
Es el tipo de entidad que recibe el foco cuando se coloca el cursor del mouse. También afecta qué entidad se selecciona con un clic del mouse y qué elemento de la tabla de datos está asociado con los eventos. Puede ser una de las siguientes opciones:
En el campo "category" (categoría) de FocusTarget, el cuadro de información muestra todos los valores de la categoría. Esto puede ser útil para comparar valores de diferentes series. Tipo: string
Predeterminado: "datum"
|
fontSize |
El tamaño de fuente predeterminado, en píxeles, de todo el texto en el gráfico. Puedes anular esto usando propiedades para elementos específicos del gráfico. Tipo: Número
Predeterminada: automática
|
fontName |
Es el tipo de fuente predeterminado para todo el texto del gráfico. Puedes anular esto usando propiedades para elementos específicos del gráfico. Tipo: string
Predeterminado: "Arial"
|
forceIFrame |
Dibuja el gráfico dentro de un marco intercalado. (Ten en cuenta que, en IE8, esta opción se ignora; todos los gráficos de IE8 se dibujan en iframes). Tipo: booleano
Predeterminado: falso
|
hAxis |
Un objeto con miembros para configurar varios elementos del eje horizontal. Para especificar las propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Tipo: objeto
Valor predeterminado: nulo
|
hAxis.gridlines |
Un objeto con propiedades para configurar las líneas de cuadrícula en el eje horizontal. Ten en cuenta que las líneas de cuadrícula del eje horizontal se dibujan de forma vertical. Para especificar propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: {color: '#333', minSpacing: 20} Tipo: objeto
Valor predeterminado: nulo
|
hAxis.gridlines.color |
El color de las líneas de cuadrícula horizontales dentro del área del gráfico. Especifica una cadena de color HTML válida. Tipo: string
Predeterminado: “#CCC”
|
hAxis.gridlines.count |
Es la cantidad aproximada de líneas de cuadrícula horizontales dentro del área del gráfico.
Si especificas un número positivo para Tipo: Número
Valor predeterminado: -1
|
hAxis.gridlines.interval |
Es un array de tamaños (como valores de datos, no píxeles) entre líneas de cuadrícula adyacentes. Por el momento, esta opción solo es para ejes numéricos, pero es similar a las opciones de Tipo: Número entre 1 y 10, sin incluir el 10.
Predeterminado: computado
|
hAxis.gridlines.minSpacing |
Es el espacio de pantalla mínimo, en píxeles, entre las líneas de cuadrícula principales de hAxis.
El valor predeterminado para las líneas de cuadrícula principales es Tipo: Número
Predeterminado: computado
|
hAxis.gridlines.multiple |
Todos los valores de líneas de cuadrícula y marcas deben ser múltiplos del valor de esta opción. Ten en cuenta que, a diferencia de los intervalos, no se consideran potencias de 10 veces el múltiplo.
Por lo tanto, puedes hacer que las marcas sean números enteros si especificas Tipo: Número
Configuración predeterminada: 1
|
hAxis.gridlines.units |
Anula el formato predeterminado para varios aspectos de los tipos de datos de fecha/fecha y hora/hora del día cuando se usa con líneas de cuadrícula calculadas por el gráfico. Permite dar formato a años, meses, días, horas, minutos, segundos y milisegundos. El formato general es: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Puedes encontrar información adicional en Fechas y horarios. Tipo: objeto
Valor predeterminado: nulo
|
hAxis.minorGridlines |
Un objeto con miembros para configurar las líneas de cuadrícula secundarias en el eje horizontal, similar a la opción hAxis.gridlines. Tipo: objeto
Valor predeterminado: nulo
|
hAxis.minorGridlines.color |
El color de las líneas de cuadrícula horizontales secundarias dentro del área del gráfico. Especifica una cadena de color HTML válida. Tipo: string
Predeterminado: Una combinación de los colores de la línea de cuadrícula y del fondo
|
hAxis.minorGridlines.count |
La opción Tipo: Número
Configuración predeterminada:1
|
hAxis.minorGridlines.interval |
La opción minorGridlines.interval es como la opción de intervalo de líneas de cuadrícula principales, pero el intervalo que se elija siempre será un divisor par del intervalo de líneas de cuadrícula principal.
El intervalo predeterminado para las escalas lineales es Tipo: Número
Configuración predeterminada:1
|
hAxis.minorGridlines.minSpacing |
Es el espacio mínimo requerido, en píxeles, entre las líneas de cuadrícula secundarias adyacentes y entre las líneas de cuadrícula secundarias y principales. El valor predeterminado es 1/2 el espaciado mínimo de las líneas de cuadrícula principales para escalas lineales y 1/5 el espaciado mínimo para las escalas logarítmicas. Tipo: Número
Predeterminado: computado
|
hAxis.minorGridlines.multiple |
Igual que para la Tipo: Número
Configuración predeterminada: 1
|
hAxis.minorGridlines.units |
Anula el formato predeterminado para varios aspectos de los tipos de datos de fecha, fecha y hora y hora del día cuando se usa con el gráfico menorGridlines calculada. Permite formatear años, meses, días, horas, minutos, segundos y milisegundos. El formato general es: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Puedes encontrar información adicional en Fechas y horarios. Tipo: objeto
Valor predeterminado: nulo
|
hAxis.textPosition |
Posición del texto del eje horizontal, en relación con el área del gráfico. Valores admitidos: “out”, “in”, “none”. Tipo: string
Configuración predeterminada: "out"
|
hAxis.textStyle |
Un objeto que especifica el estilo de texto del eje horizontal. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.title |
La propiedad Tipo: string
Valor predeterminado: nulo
|
hAxis.titleTextStyle |
Un objeto que especifica el estilo de texto del título del eje horizontal. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.allowContainerBoundaryTextCutoff |
Si se establece como falso, se ocultarán las etiquetas más externas en lugar de permitir que el contenedor del gráfico las recorte. Si es verdadero, se permitirá el recorte de etiquetas. Tipo: booleano
Predeterminado: falso
|
hAxis.slantedText |
Si es verdadero, dibuja el texto del eje horizontal en un ángulo para ayudar a que se ajuste más texto a lo largo del eje; si se establece como falso, dibuja el texto del eje horizontal en posición vertical. El comportamiento predeterminado es inclinar el texto si no puede caber todo cuando se dibuja en posición vertical. Ten en cuenta que esta opción solo está disponible cuando Tipo: booleano
Predeterminada: automática
|
hAxis.slantedTextAngle |
El ángulo del texto del eje horizontal, si se dibuja inclinado. Se ignora si Tipo: número, de -90 a 90.
Valor predeterminado: 30
|
hAxis.maxAlternation |
Cantidad máxima de niveles de texto en el eje horizontal. Si las etiquetas de texto del eje se sobrecargan demasiado, el servidor puede mover las etiquetas vecinas hacia arriba o hacia abajo para que las etiquetas quepan más juntas. Este valor especifica la mayor cantidad de niveles que se usarán. Si las etiquetas pueden caber sin superponerse, el servidor puede usar menos niveles. Para las fechas y horas, el valor predeterminado es 1. Tipo: Número
Valor predeterminado: 2
|
hAxis.maxTextLines |
Cantidad máxima de líneas permitidas para las etiquetas de texto. Las etiquetas pueden abarcar varias líneas si son demasiado largas y, de forma predeterminada, la cantidad de líneas está limitada por la altura del espacio disponible. Tipo: Número
Predeterminada: automática
|
hAxis.minTextSpacing |
Espaciado horizontal mínimo, en píxeles, permitido entre dos etiquetas de texto adyacentes. Si las etiquetas están demasiado densas o son demasiado largas, el espaciado puede caer por debajo de este umbral y, en este caso, se aplicará una de las medidas de limpieza de etiquetas (p. ej., truncar las etiquetas o descartar algunas de ellas). Tipo: Número
Predeterminado: El valor de
hAxis.textStyle.fontSize |
hAxis.showTextEvery |
Cuántas etiquetas del eje horizontal mostrar, donde 1 significa mostrar todas las etiquetas, 2 significa mostrar todas las demás y así sucesivamente. De forma predeterminada, se intenta mostrar tantas etiquetas como sea posible sin superponerse. Tipo: Número
Predeterminada: automática
|
hAxis.viewWindowMode |
Especifica cómo escalar el eje horizontal para renderizar los valores dentro del área del gráfico. Se admiten los siguientes valores de cadena:
Tipo: string
Predeterminado: Equivalente a "pretty", pero
haxis.viewWindow.min y haxis.viewWindow.max tienen prioridad si se usan.
|
hAxis.viewWindow |
Especifica el rango de recorte del eje horizontal. Tipo: objeto
Valor predeterminado: nulo
|
hAxis.viewWindow.max |
El índice de fila basado en cero donde finaliza la ventana de recorte. Se recortarán los datos de este índice y
superiores. Junto con Se ignora cuando Tipo: Número
Predeterminada: automática
|
hAxis.viewWindow.min |
El índice de fila basado en cero donde comienza la ventana de recorte. Se recortarán los datos de los índices inferiores a esta cifra. Junto con Se ignora cuando Tipo: Número
Predeterminada: automática
|
histogram.bucketSize |
Codifica el tamaño de cada barra de histograma, en lugar de dejar que se determine de manera algorítmica. Tipo: Número
Predeterminada: automática
|
histogram.hideBucketItems |
Omite las divisiones finas entre los bloques del histograma y conviértelo en una serie de barras sólidas. Tipo: booleano
Predeterminado: falso
|
histogram.lastBucketPercentile |
Cuando calcules el tamaño del bucket del histograma, ignora el Tipo: Número
Valor predeterminado: 0
|
histogram.minValue |
Expande el rango de buckets para incluir este valor. Tipo: Número
Predeterminado: automático - usar mínimo de datos
|
histogram.maxValue |
Expande el rango de buckets para incluir este valor. Tipo: Número
Predeterminada: automático (usar máximo de datos)
|
histogram.numBucketsRule |
Cómo calcular la cantidad predeterminada de buckets Los valores posibles son:
Tipo: string
Valor predeterminado:
'sqrt' |
height |
Altura del gráfico en píxeles. Tipo: Número
Predeterminado: la altura del elemento contenedor
|
interpolateNulls |
Indica si adivinar el valor de los puntos faltantes. Si es verdadero, adivinará el valor de cualquier dato faltante en función de los puntos vecinos. Si es falso, dejará una pausa en la línea en el punto desconocido.
Esto no es compatible con los gráficos de área con la opción Tipo: booleano
Predeterminado: falso
|
isStacked |
Si se configura como verdadera, apila los elementos de todas las series en cada valor de dominio. Nota: En los gráficos Column, Area y SteppedArea, los gráficos de Google revierten el orden de los elementos de la leyenda para que se correspondan mejor con la apilado de los elementos de la serie (p.ej., la serie 0 será el elemento de leyenda más bajo). Esto no se aplica a los gráficos de barras.
La opción Las opciones para
Para apilar el 100%, el valor calculado de cada elemento aparecerá en la información sobre la herramienta después de su valor real.
De forma predeterminada, el eje objetivo mostrará valores de marca basados en la escala relativa 0-1 como fracciones
de 1 para
La pila al 100% solo admite valores de datos de tipo Tipo: booleano/cadena
Predeterminado: falso
|
leyenda |
Un objeto con miembros para configurar varios aspectos de la leyenda. Para especificar las propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Tipo: objeto
Valor predeterminado: nulo
|
legend.alignment |
Alineación de la leyenda Puede ser una de las siguientes:
El inicio, el centro y el final están relacionados con el estilo (horizontal o vertical) de la leyenda. Por ejemplo, en una leyenda "derecha", "inicio" y "final" están en la parte inferior y superior, respectivamente. En el caso de una leyenda "superior", "inicio" y "final" estarían a la izquierda y a la derecha del área, respectivamente. El valor predeterminado depende de la posición de la leyenda. Para las leyendas “inferior”, el valor predeterminado es “center”; para las leyendas “inferior”, el valor predeterminado es “start”. Tipo: string
Predeterminada: automática
|
legend.maxLines |
Cantidad máxima de líneas en la leyenda. Configúralo en un número mayor que uno para agregar líneas a tu leyenda. Nota: La lógica exacta que se usa para determinar el número real de líneas renderizadas sigue en proceso de cambio. Por el momento, esta opción solo funciona cuando legend.position es “top”. Tipo: Número
Configuración predeterminada: 1
|
legend.pageIndex |
Índice inicial de página basado en cero seleccionado de la leyenda. Tipo: Número
Valor predeterminado: 0
|
legend.position |
Posición de la leyenda. Puede ser una de las siguientes:
Tipo: string
Configuración predeterminada: "derecha"
|
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> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
orientación |
La orientación del gráfico. Cuando se establece en Tipo: string
Configuración predeterminada: "horizontal"
|
reverseCategories |
Si se establece como verdadera, se dibujará la serie de derecha a izquierda. La configuración predeterminada es dibujar de izquierda a derecha. Tipo: booleano
Predeterminado: falso
|
series |
Un array de objetos, cada uno de los cuales describe el formato de la serie correspondiente en el gráfico. Si quieres usar valores predeterminados para una serie, especifica un objeto vacío {}. Si no se especifica una serie o un valor, se usará el valor global. Cada objeto admite las siguientes propiedades:
Puedes especificar un array de objetos, cada uno de los cuales se aplica a la serie en el orden dado, o puedes especificar un objeto en el que cada elemento secundario tenga una clave numérica que indique a qué serie se aplica. Por ejemplo, las dos declaraciones siguientes son idénticas y declaran la primera serie como negra y ausente en la leyenda, y la cuarta como roja y ausente de la leyenda: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Tipo: Arreglo de objetos o con objetos anidados
Predeterminado: {}
|
tema |
Un tema es un conjunto de valores de opciones predefinidos que trabajan en conjunto para lograr un comportamiento o efecto visual de gráfico específico. Por el momento, solo hay un tema disponible:
Tipo: string
Valor predeterminado: nulo
|
título |
Es el texto que se mostrará sobre el gráfico. Tipo: string
Configuración predeterminada: Sin título
|
titlePosition |
Dónde colocar el título del gráfico en comparación con el área del gráfico Valores admitidos:
Tipo: string
Configuración predeterminada: "out"
|
titleTextStyle |
Un objeto que especifica el estilo de texto del título. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
cuadro de información |
Un objeto con miembros para configurar varios elementos de información sobre la herramienta. Para especificar propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: {textStyle: {color: '#FF0000'}, showColorCode: true} Tipo: objeto
Valor predeterminado: nulo
|
tooltip.isHtml |
Si la estableces como verdadera, usa información sobre la herramienta renderizada por HTML (en lugar de SVG). Consulta Cómo personalizar el contenido de la información sobre la herramienta para obtener más detalles. Nota: La personalización del contenido HTML de la información sobre la herramienta mediante el rol de datos de la columna de información no es compatible con la visualización del diagrama de burbujas. Tipo: booleano
Predeterminado: falso
|
tooltip.showColorCode |
Si esta preferencia se establece como "true", muestra cuadrados de color junto a la información de la serie en el cuadro de información. El valor predeterminado es verdadero cuando Tipo: booleano
Predeterminada: automática
|
tooltip.textStyle |
Un objeto que especifica el estilo de texto de la información sobre la herramienta. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
La interacción del usuario que hace que se muestre el cuadro de información:
Tipo: string
Predeterminado: "foco"
|
vAxes |
Especifica las propiedades de los ejes verticales individuales en caso de que el gráfico tenga varios ejes verticales.
Cada objeto secundario es un objeto
Para especificar un gráfico con varios ejes verticales, primero define un nuevo eje con { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } }
Esta propiedad puede ser un objeto o un array: el objeto es una colección de objetos, cada uno con una etiqueta numérica que especifica el eje que define. Este es el formato que se muestra arriba. El array es un array de objetos, uno por eje. Por ejemplo, la siguiente notación de estilo de array es idéntica al objeto vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] Tipo: Arreglo de objetos o de objetos con objetos secundarios
Valor predeterminado: nulo
|
vAxis |
Un objeto con miembros para configurar varios elementos del eje vertical. Para especificar las propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Tipo: objeto
Valor predeterminado: nulo
|
vAxis.baseline |
La propiedad Tipo: Número
Predeterminada: automática
|
vAxis.baselineColor |
Especifica el color de la línea de base para el eje vertical. Puede ser cualquier cadena HTML de color, por ejemplo: Tipo: Número
Predeterminado: “negro”
|
vAxis.direction |
La dirección en la que crecen los valores a lo largo del eje vertical. De forma predeterminada, los valores bajos
se muestran en la parte inferior del gráfico. Especifica Tipo: 1 o -1
Configuración predeterminada: 1
|
vAxis.format |
Una cadena de formato para etiquetas de ejes numéricos. Este es un subconjunto del
conjunto de patrones de ICU
.
Por ejemplo,
El formato real que se aplica a la etiqueta se deriva de la configuración regional con la que se cargó la API. Para obtener más detalles, consulta cómo cargar gráficos con una configuración regional específica .
En el cálculo de los valores de marcas y las líneas de cuadrícula, se considerarán varias combinaciones alternativas de todas las opciones de líneas de cuadrícula relevantes, y las alternativas se rechazarán si se duplican o se superponen las etiquetas de marca con formato.
Por lo tanto, puedes especificar Tipo: string
Predeterminada: automática
|
vAxis.gridlines |
Un objeto con miembros para configurar las líneas de cuadrícula en el eje vertical. Ten en cuenta que las líneas de cuadrícula del eje vertical se dibujan de forma horizontal. Para especificar las propiedades de este objeto, puedes usar la notación literal de objeto, como se muestra a continuación: {color: '#333', minSpacing: 20} Tipo: objeto
Valor predeterminado: nulo
|
vAxis.gridlines.color |
El color de las líneas de cuadrícula verticales dentro del área del gráfico Especifica una cadena de color HTML válida. Tipo: string
Predeterminado: “#CCC”
|
vAxis.gridlines.count |
Es la cantidad aproximada de líneas de cuadrícula horizontales dentro del área del gráfico.
Si especificas un número positivo para Tipo: Número
Valor predeterminado: -1
|
vAxis.gridlines.interval |
Es un array de tamaños (como valores de datos, no píxeles) entre líneas de cuadrícula adyacentes. Por el momento, esta opción solo es para ejes numéricos, pero es similar a las opciones de Tipo: Número entre 1 y 10, sin incluir el 10.
Predeterminado: computado
|
vAxis.gridlines.minSpacing |
Es el espacio de pantalla mínimo, en píxeles, entre las líneas de cuadrícula principales de hAxis.
El valor predeterminado para las líneas de cuadrícula principales es Tipo: Número
Predeterminado: computado
|
vAxis.gridlines.multiple |
Todos los valores de líneas de cuadrícula y marcas deben ser múltiplos del valor de esta opción. Ten en cuenta que, a diferencia de los intervalos, no se consideran potencias de 10 veces el múltiplo.
Por lo tanto, puedes hacer que las marcas sean números enteros si especificas Tipo: Número
Configuración predeterminada: 1
|
vAxis.gridlines.units |
Anula el formato predeterminado para varios aspectos de los tipos de datos de fecha/fecha y hora/hora del día cuando se usa con líneas de cuadrícula calculadas por el gráfico. Permite dar formato a años, meses, días, horas, minutos, segundos y milisegundos. El formato general es: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]}, hours: {format: [/*format strings here*/]}, minutes: {format: [/*format strings here*/]}, seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]} } } Puedes encontrar información adicional en Fechas y horarios. Tipo: objeto
Valor predeterminado: nulo
|
vAxis.minorGridlines |
Un objeto con miembros para configurar las líneas de cuadrícula secundarias en el eje vertical, similar a la opción vAxis.gridlines. Tipo: objeto
Valor predeterminado: nulo
|
vAxis.minorGridlines.color |
El color de las líneas de cuadrícula verticales secundarias dentro del área del gráfico. Especifica una cadena de color HTML válida. Tipo: string
Predeterminado: Una combinación de los colores de la línea de cuadrícula y del fondo
|
vAxis.minorGridlines.count |
La opción minorGridlines.count está obsoleta en su mayoría, excepto para inhabilitar las líneas de cuadrícula secundarias si se establece el recuento en 0. La cantidad de líneas de cuadrícula menores depende del intervalo entre las líneas de cuadrícula principales (consulta vAxis.gridlines.interval) y el espacio mínimo requerido (consulta vAxis.minorGridlines.minSpacing). Tipo: Número
Configuración predeterminada: 1
|
vAxis.minorGridlines.interval |
La opción minorGridlines.interval es como la opción de intervalo de líneas de cuadrícula principales, pero el intervalo que se elija siempre será un divisor par del intervalo de líneas de cuadrícula principal.
El intervalo predeterminado para las escalas lineales es Tipo: Número
Configuración predeterminada:1
|
vAxis.minorGridlines.minSpacing |
Es el espacio mínimo requerido, en píxeles, entre las líneas de cuadrícula secundarias adyacentes y entre las líneas de cuadrícula secundarias y principales. El valor predeterminado es 1/2 el espaciado mínimo de las líneas de cuadrícula principales para escalas lineales y 1/5 el espaciado mínimo para las escalas logarítmicas. Tipo: Número
Predeterminado: computado
|
vAxis.minorGridlines.multiple |
Igual que para la Tipo: Número
Configuración predeterminada: 1
|
vAxis.minorGridlines.units |
Anula el formato predeterminado para varios aspectos de los tipos de datos de fecha, fecha y hora y hora del día cuando se usa con el gráfico menorGridlines calculada. Permite formatear años, meses, días, horas, minutos, segundos y milisegundos. El formato general es: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Puedes encontrar información adicional en Fechas y horarios. Tipo: objeto
Valor predeterminado: nulo
|
vAxis.logScale |
Si es verdadero, el eje vertical es una escala logarítmica. Nota: Todos los valores deben ser positivos. Tipo: booleano
Predeterminado: falso
|
vAxis.scaleType |
La propiedad
Tipo: string
Valor predeterminado: nulo
|
vAxis.textPosition |
Posición del texto del eje vertical, en relación con el área del gráfico. Valores admitidos: “out”, “in”, “none”. Tipo: string
Configuración predeterminada: "out"
|
vAxis.textStyle |
Un objeto que especifica el estilo de texto del eje vertical. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.ticks |
Reemplaza las marcas del eje Y generadas automáticamente por el array especificado. Cada elemento del array debe ser un valor de marca válido (como un número, fecha, fecha y hora o timeofday) o un objeto. Si es un objeto, debe tener una propiedad
ViewWindow se expandirá automáticamente para incluir las marcas mínimas y máximas, a menos que especifiques Ejemplos:
Tipo: Arreglo de elementos
Predeterminada: automática
|
vAxis.title |
La propiedad Tipo: string
Configuración predeterminada: Sin título
|
vAxis.titleTextStyle |
Un objeto que especifica el estilo de texto del título del eje vertical. El objeto tiene este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Tipo: objeto
Predeterminado:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
Mueve el valor máximo del eje vertical al valor especificado; este aparecerá hacia arriba en la mayoría de los gráficos. Se ignora si se establece en un valor inferior al valor Y máximo de los datos.
Tipo: Número
Predeterminada: automática
|
vAxis.minValue |
Mueve el valor mínimo del eje vertical al valor especificado; este aparecerá hacia abajo en la mayoría de los gráficos. Se ignora si se establece en un valor mayor que el valor Y mínimo de los datos.
Tipo: Número
Valor predeterminado: nulo
|
vAxis.viewWindowMode |
Especifica cómo escalar el eje vertical para renderizar los valores dentro del área del gráfico. Se admiten los siguientes valores de cadena:
Tipo: string
Predeterminado: Equivalente a "pretty", pero
vaxis.viewWindow.min y vaxis.viewWindow.max tienen prioridad si se usan.
|
vAxis.viewWindow |
Especifica el rango de recorte del eje vertical. Tipo: objeto
Valor predeterminado: nulo
|
vAxis.viewWindow.max |
El valor máximo de datos verticales que se renderizará. Se ignora cuando Tipo: Número
Predeterminada: automática
|
vAxis.viewWindow.min |
El valor de datos vertical mínimo que se renderizará. Se ignora cuando Tipo: Número
Predeterminada: automática
|
width |
Es el ancho del gráfico (en píxeles). Tipo: Número
Predeterminado: Ancho del elemento contenedor
|
Métodos
Método | |
---|---|
draw(data, options) |
Dibuja el gráfico. El gráfico acepta más llamadas de método solo después de que se activa el evento Tipo de datos que se muestra: ninguno
|
getAction(actionID) |
Muestra el objeto de acción de información sobre la herramienta con el Tipo de datos que se muestra: objeto
|
getBoundingBox(id) |
Muestra un objeto que contiene las partes izquierda, superior, ancho y altura del elemento
Los valores están relacionados con el contenedor del gráfico. Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: objeto
|
getChartAreaBoundingBox() |
Muestra un objeto que contiene la parte izquierda, superior, ancho y altura del contenido del gráfico (es decir, sin incluir las etiquetas ni la leyenda):
Los valores están relacionados con el contenedor del gráfico. Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: objeto
|
getChartLayoutInterface() |
Muestra un objeto que contiene información sobre la ubicación del gráfico y sus elementos en la pantalla. Se puede llamar a los siguientes métodos en el objeto que se muestra:
Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: objeto
|
getHAxisValue(xPosition, optional_axis_index) |
Muestra el valor de datos horizontales en Ejemplo: Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: número
|
getImageURI() |
Muestra el gráfico serializado como un URI de imagen. Llámalo después de que se dibuje el gráfico. Consulta Cómo imprimir gráficos en PNG. Tipo de datos que se muestra: string
|
getSelection() |
Muestra un array de las entidades del gráfico seleccionadas.
Las entidades seleccionables son barras, entradas de leyenda y categorías.
Para este gráfico, solo se puede seleccionar una entidad en un momento determinado.
Tipo de datos que se muestra: Es el array de elementos de selección.
|
getVAxisValue(yPosition, optional_axis_index) |
Muestra el valor de datos verticales en Ejemplo: Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: número
|
getXLocation(dataValue, optional_axis_index) |
Muestra la coordenada X del píxel de Ejemplo: Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: número
|
getYLocation(dataValue, optional_axis_index) |
Muestra la coordenada Y del píxel de Ejemplo: Llámalo después de que se dibuje el gráfico. Tipo de datos que se muestra: número
|
removeAction(actionID) |
Quita del gráfico la acción de información sobre la herramienta con el Tipo de datos que se muestra:
none |
setAction(action) |
Establece una acción de información sobre la herramienta que se ejecutará cuando el usuario haga clic en el texto de acción.
El método
Todas las acciones de información sobre la herramienta se deben configurar antes de llamar al método Tipo de datos que se muestra:
none |
setSelection() |
Selecciona las entidades del gráfico especificadas. Cancela cualquier selección anterior.
Las entidades seleccionables son barras, entradas de leyenda y categorías.
Para este gráfico, solo se puede seleccionar una entidad a la vez.
Tipo de datos que se muestra: ninguno
|
clearChart() |
Borra el gráfico y libera todos sus recursos asignados. Tipo de datos que se muestra: ninguno
|
Eventos
Para obtener más información sobre cómo usar estos eventos, consulta Interactividad básica, Cómo controlar eventos y Cómo activar eventos.
Nombre | |
---|---|
animationfinish |
Se activa cuando se completa la animación de transición. Propiedades: ninguna
|
click |
Se activa cuando el usuario hace clic en el gráfico. 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 cuando se intenta renderizar el gráfico. Propiedades: ID, mensaje
|
legendpagination |
Se activa cuando el usuario hace clic en las flechas de paginación de la leyenda. Devuelve el índice de páginas basado en cero de la leyenda actual y la cantidad total de páginas. Propiedades: currentPageIndex, totalPages
|
onmouseover |
Se activa cuando el usuario desplaza el mouse sobre una entidad visual. Devuelve los índices de fila y columna del elemento de tabla de datos correspondiente. Una barra se correlaciona con una celda de la tabla de datos, una leyenda en una columna (el índice de fila es nulo) y una categoría con una fila (el índice de la columna es nulo). Propiedades:fila, columna
|
onmouseout |
Se activa cuando el usuario aleja el mouse de una entidad visual. Devuelve los índices de filas y columnas del elemento de tabla de datos correspondiente. Una barra se correlaciona con una celda de la tabla de datos, una leyenda en una columna (el índice de fila es nulo) y una categoría con una fila (el índice de la columna es nulo). Propiedades:fila, columna
|
ready |
El gráfico está listo para llamadas de método externas. Si deseas interactuar con el gráfico y llamar a los métodos después de dibujarlo, debes configurar un objeto de escucha para este evento antes de llamar al método Propiedades: ninguna
|
select |
Se activa cuando el usuario hace clic en una entidad visual. Para saber qué se seleccionó, llama a Propiedades: ninguna
|
Política de Datos
Todo el código y los datos se procesan y renderizan en el navegador. No se envían datos a ningún servidor.