การแสดงภาพของคุณสามารถเริ่มการทํางานของเหตุการณ์ที่หน้าโฮสต์สามารถลงทะเบียนเพื่อรับได้ เหตุการณ์สามารถเริ่มทํางานได้โดยผู้ใช้ เช่น การคลิกแผนภูมิหรือเหตุการณ์ภายในได้ เช่น การเริ่มทํางานเหตุการณ์ทุก 10 วินาที คุณสามารถลงทะเบียนเมธอด JavaScript เมื่อมีการเรียกใช้เหตุการณ์บางอย่างได้ ซึ่งอาจมีข้อมูลเฉพาะสําหรับเหตุการณ์นั้น
ภาพทุกภาพกําหนดเหตุการณ์ของตนเอง และเอกสารอธิบายการแสดงภาพนั้นควรเริ่มทํางานเมื่อเหตุการณ์แต่ละรายการเริ่มทํางาน ความหมายของเหตุการณ์ และข้อมูลที่ส่งไปยังเครื่องจัดการเหตุการณ์ (เช่น ดูการแสดงภาพองค์กร หน้านี้อธิบายวิธีที่ครีเอเตอร์ภาพเริ่มทํางาน โปรดดูหน้าการจัดการเหตุการณ์เพื่อดูวิธีที่ลูกค้าลงทะเบียนเพื่อรับกิจกรรม
มีเหตุการณ์หนึ่งที่ภาพที่เลือกได้ควรเริ่มทํางาน คือเหตุการณ์ที่เลือก แต่ลักษณะการทํางานและความหมายของเหตุการณ์นี้จะกําหนดโดยการแสดงภาพแต่ละภาพ
หากการแสดงภาพยังไม่พร้อมสําหรับการโต้ตอบทันทีหลังจากที่เมธอด draw
ส่งคืนการควบคุมให้กับผู้ใช้ การแสดงภาพควรเริ่มทํางาน นั่นคือเหตุการณ์พร้อม
พฤติกรรมที่ชัดเจนและความหมายของเหตุการณ์นี้จะอยู่ในหัวข้อเหตุการณ์พร้อมแล้ว
โปรดทราบว่าเหตุการณ์การแสดงภาพ API นั้นแยกต่างหากและแตกต่างจากเหตุการณ์ DOM มาตรฐาน
เนื้อหา
การเริ่มทํางานของกิจกรรม
หากต้องการเริ่มการทํางานของเหตุการณ์จากการแสดงภาพ ให้เรียกใช้ฟังก์ชัน google.visualization.events.trigger()
ฟังก์ชันควรมีพารามิเตอร์ต่อไปนี้
- การแสดงภาพต้นฉบับ (โดยทั่วไปคือค่า
this
) - ชื่อเหตุการณ์ (สตริง)
- รายละเอียดเหตุการณ์ (ออบเจ็กต์) แผนที่ (ชื่อ/ค่า) ที่ไม่บังคับของรายละเอียดเหตุการณ์เฉพาะ
ตัวอย่างต่อไปนี้จะแสดงให้เห็นว่าการแสดงภาพทําให้เกิดเหตุการณ์ที่เลือกอย่างไร
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" เป็นเหตุการณ์มาตรฐานที่มีการแสดงภาพจํานวนมากเพื่อตอบสนองต่อการคลิกเมาส์ของผู้ใช้ หากเลือกให้เหตุการณ์เริ่มทํางานเมื่อคลิกเมาส์ คุณควรใช้เหตุการณ์ "เลือก" ตามวิธีมาตรฐานที่อธิบายไว้ที่นี่
- เริ่มการทํางานของเหตุการณ์ชื่อ "select" เมื่อผู้ใช้เลือกข้อมูลบางอย่างภายในการแสดงภาพ เหตุการณ์จะไม่ส่งอาร์กิวเมนต์ใดๆ ไปยังฟังก์ชันการฟัง
- แสดงเมธอด
getSelection()
ตามที่อธิบายไว้ในส่วนเอกสารที่ลิงก์ วิธีนี้ควรแสดงดัชนีขององค์ประกอบ data ที่ผู้ใช้เลือก
- แสดงเมธอด
setSelection()
ตามที่อธิบายไว้ในส่วนการอ้างอิง นอกจากนี้ โปรดดูหน้าการจัดการเหตุการณ์เพื่อดูวิธีจัดการเหตุการณ์
กิจกรรมสําเร็จรูป
การแสดงภาพใดๆ ควรเรียกเหตุการณ์ "พร้อม" ที่ทํางานด้วยวิธีมาตรฐานเพื่อแจ้งให้นักพัฒนาแอปทราบเมื่อการแสดงภาพพร้อมประมวลผลเมธอดที่เรียกว่า (อย่างไรก็ตาม ไม่มีข้อกําหนดตายตัวว่าการแสดงภาพทํางานในลักษณะนี้ ดูเอกสารประกอบสําหรับการแสดงภาพของคุณ)
โดยทั่วไป การแสดงภาพที่แสดงเหตุการณ์ "พร้อม" จะออกแบบมาให้เป็นไปตามข้อกําหนดต่อไปนี้
- เหตุการณ์ที่พร้อมใช้งานจะไม่ส่งพร็อพเพอร์ตี้ใดๆ ไปยังเครื่องจัดการ (เครื่องจัดการฟังก์ชันไม่ควรคาดหวังให้มีการส่งพารามิเตอร์ใดๆ ไปยังพารามิเตอร์ดังกล่าว)
- การแสดงภาพควรเริ่มทํางานของเหตุการณ์ที่พร้อมแสดงหลังจากการแสดงภาพพร้อมสําหรับการโต้ตอบ
หากการวาดของการแสดงภาพไม่พร้อมกัน เหตุการณ์นั้นจะเริ่มทํางานเมื่อเรียกใช้เมธอดการโต้ตอบได้จริง ไม่ใช่เฉพาะเมื่อเมธอด
draw
สิ้นสุดลง - คุณควรเพิ่ม Listener ให้กับเหตุการณ์นี้ก่อนเรียกใช้เมธอด
draw
เพราะจะทําให้เหตุการณ์เริ่มทํางานได้ก่อนที่จะตั้งค่า Listener และคุณจะไม่สามารถตรวจจับได้ - การเรียกเมธอดการโต้ตอบก่อนที่เหตุการณ์พร้อมจะเริ่มทํางานจะมีความเสี่ยงที่เมธอดเหล่านี้จะทํางานไม่ถูกต้อง
รูปแบบการประชุมก็คือ ภาพที่ไม่เริ่มทํางานเหตุการณ์ "พร้อม" จะพร้อมสําหรับการโต้ตอบทันทีหลังจากที่เมธอด draw
สิ้นสุด และแสดงผลการควบคุมให้กับผู้ใช้