การเริ่มเหตุการณ์

การแสดงภาพของคุณสามารถเริ่มการทํางานของเหตุการณ์ที่หน้าโฮสต์สามารถลงทะเบียนเพื่อรับได้ เหตุการณ์สามารถเริ่มทํางานได้โดยผู้ใช้ เช่น การคลิกแผนภูมิหรือเหตุการณ์ภายในได้ เช่น การเริ่มทํางานเหตุการณ์ทุก 10 วินาที คุณสามารถลงทะเบียนเมธอด JavaScript เมื่อมีการเรียกใช้เหตุการณ์บางอย่างได้ ซึ่งอาจมีข้อมูลเฉพาะสําหรับเหตุการณ์นั้น

ภาพทุกภาพกําหนดเหตุการณ์ของตนเอง และเอกสารอธิบายการแสดงภาพนั้นควรเริ่มทํางานเมื่อเหตุการณ์แต่ละรายการเริ่มทํางาน ความหมายของเหตุการณ์ และข้อมูลที่ส่งไปยังเครื่องจัดการเหตุการณ์ (เช่น ดูการแสดงภาพองค์กร หน้านี้อธิบายวิธีที่ครีเอเตอร์ภาพเริ่มทํางาน โปรดดูหน้าการจัดการเหตุการณ์เพื่อดูวิธีที่ลูกค้าลงทะเบียนเพื่อรับกิจกรรม

มีเหตุการณ์หนึ่งที่ภาพที่เลือกได้ควรเริ่มทํางาน คือเหตุการณ์ที่เลือก แต่ลักษณะการทํางานและความหมายของเหตุการณ์นี้จะกําหนดโดยการแสดงภาพแต่ละภาพ

หากการแสดงภาพยังไม่พร้อมสําหรับการโต้ตอบทันทีหลังจากที่เมธอด draw ส่งคืนการควบคุมให้กับผู้ใช้ การแสดงภาพควรเริ่มทํางาน นั่นคือเหตุการณ์พร้อม พฤติกรรมที่ชัดเจนและความหมายของเหตุการณ์นี้จะอยู่ในหัวข้อเหตุการณ์พร้อมแล้ว

โปรดทราบว่าเหตุการณ์การแสดงภาพ API นั้นแยกต่างหากและแตกต่างจากเหตุการณ์ DOM มาตรฐาน

เนื้อหา

  1. การเริ่มทํางาน
  2. กิจกรรม "เลือก"
  3. กิจกรรมที่พร้อมแล้ว
  4. ข้อมูลเพิ่มเติม

การเริ่มทํางานของกิจกรรม

หากต้องการเริ่มการทํางานของเหตุการณ์จากการแสดงภาพ ให้เรียกใช้ฟังก์ชัน google.visualization.events.trigger() ฟังก์ชันควรมีพารามิเตอร์ต่อไปนี้

  1. การแสดงภาพต้นฉบับ (โดยทั่วไปคือค่า this)
  2. ชื่อเหตุการณ์ (สตริง)
  3. รายละเอียดเหตุการณ์ (ออบเจ็กต์) แผนที่ (ชื่อ/ค่า) ที่ไม่บังคับของรายละเอียดเหตุการณ์เฉพาะ

ตัวอย่างต่อไปนี้จะแสดงให้เห็นว่าการแสดงภาพทําให้เกิดเหตุการณ์ที่เลือกอย่างไร 

MyVisualization.prototype.onclick = function(rowIndex) {
  this.highlightRow(this.selectedRow, false); // Clear previous selection
  this.highlightRow(rowIndex, true); // Highlight new selection

  // Save the selected row index in case getSelection is called.
  this.selectedRow = rowIndex;

  // Fire a select event.
  google.visualization.events.trigger(this, 'select', {});
};

หน้าโฮสติ้งสามารถลงทะเบียนเพื่อรับกิจกรรมของคุณโดยโทรหา google.visualization.events.addListener() หรือ google.visualization.events.addOneTimeListener() อย่าลืมบันทึกเหตุการณ์ใดๆ ที่คุณเริ่มทํางานอย่างละเอียด

กิจกรรม "เลือก"

เหตุการณ์ "select" เป็นเหตุการณ์มาตรฐานที่มีการแสดงภาพจํานวนมากเพื่อตอบสนองต่อการคลิกเมาส์ของผู้ใช้ หากเลือกให้เหตุการณ์เริ่มทํางานเมื่อคลิกเมาส์ คุณควรใช้เหตุการณ์ "เลือก" ตามวิธีมาตรฐานที่อธิบายไว้ที่นี่

  1. เริ่มการทํางานของเหตุการณ์ชื่อ "select" เมื่อผู้ใช้เลือกข้อมูลบางอย่างภายในการแสดงภาพ เหตุการณ์จะไม่ส่งอาร์กิวเมนต์ใดๆ ไปยังฟังก์ชันการฟัง
  2. แสดงเมธอด getSelection() ตามที่อธิบายไว้ในส่วนเอกสารที่ลิงก์ วิธีนี้ควรแสดงดัชนีขององค์ประกอบ data ที่ผู้ใช้เลือก
  3. แสดงเมธอด setSelection() ตามที่อธิบายไว้ในส่วนการอ้างอิง นอกจากนี้ โปรดดูหน้าการจัดการเหตุการณ์เพื่อดูวิธีจัดการเหตุการณ์

กิจกรรมสําเร็จรูป

การแสดงภาพใดๆ ควรเรียกเหตุการณ์ "พร้อม" ที่ทํางานด้วยวิธีมาตรฐานเพื่อแจ้งให้นักพัฒนาแอปทราบเมื่อการแสดงภาพพร้อมประมวลผลเมธอดที่เรียกว่า (อย่างไรก็ตาม ไม่มีข้อกําหนดตายตัวว่าการแสดงภาพทํางานในลักษณะนี้ ดูเอกสารประกอบสําหรับการแสดงภาพของคุณ)

โดยทั่วไป การแสดงภาพที่แสดงเหตุการณ์ "พร้อม" จะออกแบบมาให้เป็นไปตามข้อกําหนดต่อไปนี้

  • เหตุการณ์ที่พร้อมใช้งานจะไม่ส่งพร็อพเพอร์ตี้ใดๆ ไปยังเครื่องจัดการ (เครื่องจัดการฟังก์ชันไม่ควรคาดหวังให้มีการส่งพารามิเตอร์ใดๆ ไปยังพารามิเตอร์ดังกล่าว)
  • การแสดงภาพควรเริ่มทํางานของเหตุการณ์ที่พร้อมแสดงหลังจากการแสดงภาพพร้อมสําหรับการโต้ตอบ หากการวาดของการแสดงภาพไม่พร้อมกัน เหตุการณ์นั้นจะเริ่มทํางานเมื่อเรียกใช้เมธอดการโต้ตอบได้จริง ไม่ใช่เฉพาะเมื่อเมธอด draw สิ้นสุดลง
  • คุณควรเพิ่ม Listener ให้กับเหตุการณ์นี้ก่อนเรียกใช้เมธอด draw เพราะจะทําให้เหตุการณ์เริ่มทํางานได้ก่อนที่จะตั้งค่า Listener และคุณจะไม่สามารถตรวจจับได้
  • การเรียกเมธอดการโต้ตอบก่อนที่เหตุการณ์พร้อมจะเริ่มทํางานจะมีความเสี่ยงที่เมธอดเหล่านี้จะทํางานไม่ถูกต้อง

รูปแบบการประชุมก็คือ ภาพที่ไม่เริ่มทํางานเหตุการณ์ "พร้อม" จะพร้อมสําหรับการโต้ตอบทันทีหลังจากที่เมธอด draw สิ้นสุด และแสดงผลการควบคุมให้กับผู้ใช้

ข้อมูลเพิ่มเติม