בדף הזה מתוארים אירועים בממשק המשתמש ואירועי שגיאה שאפשר להאזין להם ולטפל בהם באופן פרוגרמטי.
אירועים בממשק המשתמש
בקטע הזה מפורטים האירועים האינטראקטיביים וההתראות על שינויים במצב שאפשר להאזין להם ולטפל בהם באופן פרוגרמטי כשעובדים עם מפות תלת-ממד. JavaScript בדפדפן מבוסס על אירועים, כלומר הוא מגיב לאינטראקציות של משתמשים על ידי יצירת אירועים שהתוכנית יכולה להאזין להם ולהריץ קוד בהתאם.
יש שני סוגים עיקריים של אירועים:
- אירועים של אינטראקציות משתמשים (כמו קליקים בעכבר) מועברים מחלון התצוגה של מפת התלת-ממד לקוד שלכם. האירועים האלה מאפשרים לכם להגיב לפעולות ישירות של משתמשים בסביבת המפה התלת-ממדית. לצפייה בדוגמה
- ההתראות על שינוי סטטוס משקפות עדכונים במודלים של נתוני המפה התלת-ממדיים הבסיסיים ובסטטוס העיבוד, באמצעות סכימת שמות מקובלת
gmp-propertychange.
כל אובייקט של API למיפוי תלת-ממדי חושף קבוצה של אירועים עם שמות שהתוכנית יכולה לרשום להם מאזינים לאירועים ולהפעיל לוגיקה כשהאירועים האלה מתרחשים באמצעות הפונקציה המובנית addEventListener().
בדוגמה הבאה אפשר לראות אילו אירועים מופעלים כשמשתמש מבצע אינטראקציה עם המפה: