與圖表互動

目前為止，我們涵蓋的網頁數量足以涵蓋許多網頁，但您之前已在網頁中繪製了圖表。但如果您想擷取使用者的點擊，或需要操控已繪製的圖表的屬性或資料，您必須監聽圖表擲回的事件。

所有圖表都會擲回某種類型的事件。最常見者如下：

  • Ready (已就緒)：在頁面上繪製圖表且已可回應方法時擲回。如需要求圖表資訊，請監聽這個事件。
  • 選取 - 使用者選取圖表中的部分時，通常按一下長條或圓餅圖區塊。
  • error - 當圖表無法顯示傳入的資料時 (通常因為 DataTable 格式有誤)。
  • onmouseover 和 onmouseout：分別在使用者將遊標懸停在特定圖表元素上時擲回。

事件監聽作業非常簡單；只要呼叫 google.visualization.events.addListener() 將要傳入圖表的處理常式、要擷取的事件名稱，以及事件擲回時要呼叫的處理常式名稱即可。您可以使用任何圖表控點呼叫此方法，即使您尚未呼叫 draw() 也沒問題。請注意，如果您希望系統先呼叫一次事件監聽器，再呼叫 google.visualization.events.addOneTimeListener()，然後再移除本身。

下列程式碼片段說明如何註冊以擷取圖表的 select 事件：

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...  }

以下是含有新選取事件監聽器的 Hello Charts 程式碼範例。親自體驗。

 <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>

 

更多資訊