Lo que hemos cubierto hasta ahora es suficiente para muchas páginas web: ha dibujado su gráfico en la página. Sin embargo, si desea captar los clics de los usuarios o necesita manipular las propiedades o los datos de un gráfico que ya dibujaste, debes detectar los eventos que arroja el gráfico.
Todos los gráficos muestran algunas clases de eventos. Aquí le presentamos los más comunes:
- Ready: Se muestra cuando el gráfico se dibuja en la página y está listo para responder a los métodos. Escucha este evento si necesitas solicitar información del gráfico.
- select: Se arroja cuando el usuario selecciona algo en el gráfico; por lo general, cuando hace clic en una barra o en un sector circular.
- error: Se muestra cuando el gráfico no puede procesar los datos que se pasaron, por lo general, porque el formato
DataTable
es incorrecto. - onmouseover y onmouseout: Se muestran cuando el usuario desplaza el mouse sobre un elemento específico del gráfico, o bien cuando lo apaga.
La detección de eventos es simple. Solo debes llamar a google.visualization.events.addListener()
y pasarle un identificador al gráfico, el nombre del evento a detectar y el nombre de un controlador al que se llamará cuando se produzca el evento. Puedes llamar a este método con cualquier controlador de gráfico, incluso si todavía no llamaste a draw()
. Ten en cuenta que puedes llamar a google.visualization.events.addOneTimeListener()
si quieres que se llame al objeto de escucha exactamente una vez antes de quitarse.
A continuación, se muestra un fragmento de código parcial que muestra cómo registrarse para capturar el evento select de un gráfico:
load libraries... function drawChart() { prepare data... var chart = new google.visualization.PieChart(document.getElementById('chart_div')); // The select handler. Call the chart's getSelection() method function selectHandler() { var selectedItem = chart.getSelection()[0]; if (selectedItem) { var value = data.getValue(selectedItem.row, selectedItem.column); alert('The user selected ' + value); } } // Listen for the 'select' event, and call my function selectHandler() when // the user selects something on the chart. google.visualization.events.addListener(chart, 'select', selectHandler); draw the chart... }
A continuación, se muestra el ejemplo de código de Hello Charts con un nuevo objeto de escucha de eventos de selección. Pruébalo.
<html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the piechart package. google.charts.load('current', {'packages':['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(drawChart); // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart() { // Create the data table. var data = new google.visualization.DataTable(); data.addColumn('string', 'Topping'); data.addColumn('number', 'Slices'); data.addRows([ ['Mushrooms', 3], ['Onions', 1], ['Olives', 1], ['Zucchini', 1], ['Pepperoni', 2] ]); // Set chart options var options = {'title':'How Much Pizza I Ate Last Night', 'width':400, 'height':300}; // Instantiate and draw our chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); function selectHandler() { var selectedItem = chart.getSelection()[0]; if (selectedItem) { var topping = data.getValue(selectedItem.row, 0); alert('The user selected ' + topping); } } google.visualization.events.addListener(chart, 'select', selectHandler); chart.draw(data, options); } </script> </head> <body> <!--Div that will hold the pie chart--> <div id="chart_div" style="width:400; height:300"></div> </body> </html>
Más información