Obsoleto
Esta visualización se reemplazó por una versión nueva. Úsala en su lugar. Para facilitar la migración, consulta la página de notas de la versión.
Descripción general
Un diagrama de dispersión que se renderiza dentro del navegador con SVG o VML. Muestra sugerencias al hacer clic en puntos.
Los diagramas de dispersión se usan para asignar la correlación entre conjuntos de números.
Por: Google
Ejemplo
Codificala tú mismo en el Playground de visualización.
<html> <head> <script type="text/javascript" src="https://www.google.com/jsapi"></script> <script type="text/javascript"> google.load("visualization", "1", {packages:["scatterchart"]}); google.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Age', 'Weight'], [ 8, 12], [ 4, 5.5], [ 11, 14], [ 4, 5], [ 3, 3.5], [ 6.5, 7] ]); var chart = new google.visualization.ScatterChart(document.getElementById('chart_div')); chart.draw(data, {width: 400, height: 240, titleX: 'Age', titleY: 'Weight', legend: 'none', pointSize: 5}); } </script> </head> <body> <div id="chart_div"></div> </body> </html>
Cargando
El nombre del paquete google.load
es "scatterchart"
google.load("visualization", "1", {packages: ["scatterchart"]});
El nombre de clase de la visualización es google.visualization.ScatterChart
var visualization = new google.visualization.ScatterChart(container);
Formato de datos
Se requieren dos o más columnas, todas deben ser numéricas. Los valores de la primera columna se usan para el eje X. Los valores en las siguientes columnas se usan para el eje Y. Cada columna se muestra con un color diferente.
Los números mínimo y máximo que se muestran en el eje X son los valores X mínimo y máximo de la tabla de datos. Para forzar que el espacio adicional se muestre por debajo o por encima de estos valores, agrega una fila con un valor X por debajo del valor de datos mínimo o superior, y no especifiques un valor Y en la fila. De esta manera, puedes agregar una fila para los valores mínimo, máximo o ambos.
Opciones de configuración
Nombre | Tipo | Predeterminado | Descripción |
---|---|---|---|
axisColor | Objeto o string | color predeterminado | El color del eje. Los valores posibles son los de la opción de configuración backgroundColor. |
axisBackgroundColor | Objeto o string | color predeterminado | El borde alrededor del fondo del eje. Los valores posibles son los de la opción de configuración backgroundColor. |
axisFontSize | número | automático | Es el tamaño de fuente del texto del eje del gráfico, en píxeles. |
backgroundColor | Objeto o string | color predeterminado | El color de fondo del área principal del gráfico.
Puede ser una de las siguientes opciones:
|
borderColor | Objeto o string | color predeterminado | El borde alrededor de los elementos del gráfico. Los valores posibles son los de la opción de configuración backgroundColor. |
colores | Arreglo de strings | Colores predeterminados | Los colores que se usarán para los elementos del gráfico. Un array de cadenas. Cada elemento es una cadena que es un color admitido por HTML, por ejemplo "rojo" o "#00cc00". |
enableTooltip | boolean | verdadero | Si se establece como verdadera, se muestran cuadros de información cuando el usuario hace clic en un dato. |
focusBorderColor | Objeto o string | color predeterminado | El borde alrededor de los elementos del gráfico que están enfocados (señalado por el mouse). Los valores posibles son los de la opción de configuración backgroundColor. |
height | número | Altura del contenedor | Es la altura del gráfico en píxeles. |
leyenda | cadena | 'derecha' | Posición y tipo de leyenda. Puede ser una de las siguientes opciones:
|
legendBackgroundColor | Objeto o string | color predeterminado | El color de fondo del área de la leyenda del gráfico. Los valores posibles son los de la opción de configuración backgroundColor. |
legendFontSize | número | automático | El tamaño de la fuente de la leyenda en píxeles. |
legendTextColor | Objeto o string | color predeterminado | El color del texto de la leyenda Los valores posibles son los de la opción de configuración backgroundColor. |
lineSize | número | 0 | Es el ancho de línea en píxeles. Utiliza valores positivos para mostrar una línea entre todos los puntos de la misma columna de datos. |
logScale | boolean | false | Si es verdadero, el eje Y debe escalarse de manera logarítmica. |
logScaleX | boolean | false | Si es verdadero, el eje X debe escalarse de manera logarítmica. |
max | número | automático | Especifica la línea de cuadrícula del eje Y más alta. La línea de cuadrícula real será el mayor de los dos valores: el valor máximo de la opción o el valor de datos más alto, redondeado hasta la siguiente marca de cuadrícula más alta. |
min | número | automático | Especifica la línea de cuadrícula del eje Y más baja. La línea de cuadrícula real será el inferior de los dos valores: el valor mínimo de la opción o el valor de datos más bajo, redondeado hacia abajo a la siguiente marca de la cuadrícula inferior. |
pointSize | número | 3 | Es el tamaño de los puntos mostrados en píxeles. |
título | cadena | sin título | Es el texto que se mostrará sobre el gráfico. |
titleX | cadena | sin título | Texto que se mostrará debajo del eje horizontal |
titleY | cadena | sin título | Texto que se mostrará en el eje vertical. |
titleColor | Objeto o string | color predeterminado | El color del título del gráfico. Los valores posibles son los de la opción de configuración backgroundColor. |
titleFontSize | número | automático | El tamaño de fuente para el título del gráfico, en píxeles. |
tooltipFontSize |
número | 11 | El tamaño de fuente del texto de información sobre la herramienta. Esto se puede reducir si la información sobre la herramienta es demasiado pequeña para contener el texto en la fuente especificada. |
tooltipHeight |
número | 60 | La altura del cuadro de información en píxeles. La altura de la información es fija; nunca aumentará ni se reducirá para adaptarse a la longitud o al tamaño de la fuente del texto. Sin embargo, se recortará cualquier valor que sea superior a 1/3 de la altura del gráfico. |
tooltipWidth | número | 120 | Es el ancho de la información sobre la herramienta en píxeles. El ancho de la información es fijo; nunca aumentará ni se reducirá para adaptarse a la longitud o al tamaño de la fuente del texto. Sin embargo, se recortarán los elementos que superen el ancho del gráfico. |
width | número | Ancho del contenedor | Es el ancho del gráfico en píxeles. |
Métodos
Método | Tipo de datos que se muestra | Descripción |
---|---|---|
draw(data, options) |
ninguno | Dibuja el gráfico. |
getSelection() |
Array de elementos de selección | Implementación estándar de getSelection()
Los elementos seleccionados son elementos de columna y celda.
El usuario solo puede seleccionar una columna o celda a la vez. |
setSelection() |
ninguno | Es la implementación estándar de setSelection() , pero admite la selección de un solo elemento.
Trata cada entrada de selección como una selección de columna o celda.
Ten en cuenta que no se pueden seleccionar la columna de etiqueta ni la primera columna numérica (la columna de valores del eje x). |
Eventos
Nombre | Descripción | Propiedades |
---|---|---|
onmouseover |
Se activa cuando el usuario desplaza el mouse sobre un punto y pasa los índices de filas y columnas de la celda correspondiente. | fila, columna |
onmouseout |
Se activa cuando el usuario aleja el mouse de un punto y pasa los índices de filas y columnas de la celda correspondiente. | 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 draw e llamarlos solo después de que se haya activado el evento. |
Ninguno |
select |
Se activa cuando el usuario hace clic en un punto o una leyenda. Cuando se selecciona un punto, se selecciona la celda correspondiente en la tabla de datos; cuando se selecciona una leyenda, se selecciona la columna correspondiente en la tabla de datos. Para saber qué se seleccionó, llama a getSelection() . |
Ninguno |
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.