הגדרה כניתנת להתקנה

האזנה לאירוע beforeinstallprompt

כשהדפדפן מפעיל את האירוע beforeinstallprompt, זה סימן שאפשר להתקין את אפליקציית האינטרנט ולהציג למשתמש את כפתור ההתקנה. האירוע beforeinstallprompt מופעל כשהאפליקציה עומדת בקריטריונים להתקנה.

תיעוד האירוע מאפשר למפתחים להתאים אישית את ההתקנה ולהציג למשתמשים בקשה להתקין את האפליקציה בזמן שהם חושבים שהוא הכי מתאים.

  1. לוחצים על שינוי הסגנון לעריכה כדי שיהיה אפשר לערוך את הפרויקט.
  2. מוסיפים גורם מטפל באירועים מסוג beforeinstallprompt לאובייקט window.
  3. שומרים את event כמשתנה גלובלי. נצטרך אותו בהמשך כדי להציג את ההודעה.
  4. מבטלים את ההסתרה של כפתור ההתקנה.

קוד:

window.addEventListener('beforeinstallprompt', (event) => {
  // Prevent the mini-infobar from appearing on mobile.
  event.preventDefault();
  console.log('👍', 'beforeinstallprompt', event);
  // Stash the event so it can be triggered later.
  window.deferredPrompt = event;
  // Remove the 'hidden' class from the install button container.
  divInstall.classList.toggle('hidden', false);
});

טיפול בלחיצה על כפתור ההתקנה

כדי להציג את ההנחיה להתקנה, צריך להפעיל את prompt() באירוע beforeinstallprompt השמור. הקריאה ל-prompt() מתבצעת ב-handler של הקליק על לחצן ההתקנה, כי צריך לקרוא ל-prompt() מתנועה של המשתמש.

  1. מוסיפים גורם מטפל באירועים מסוג קליק לכפתור ההתקנה.
  2. מפעילים את prompt() באירוע beforeinstallprompt שנשמר.
  3. מתעדים את התוצאות של ההנחיה.
  4. מגדירים את האירוע השמור beforeinstallprompt כ-null.
  5. הסתרת כפתור ההתקנה.

קוד:

butInstall.addEventListener('click', async () => {
  console.log('👍', 'butInstall-clicked');
  const promptEvent = window.deferredPrompt;
  if (!promptEvent) {
    // The deferred prompt isn't available.
    return;
  }
  // Show the install prompt.
  promptEvent.prompt();
  // Log the result
  const result = await promptEvent.userChoice;
  console.log('👍', 'userChoice', result);
  // Reset the deferred prompt variable, since
  // prompt() can only be called once.
  window.deferredPrompt = null;
  // Hide the install button.
  divInstall.classList.toggle('hidden', true);
});

מעקב אחרי אירוע ההתקנה

התקנת אפליקציית אינטרנט באמצעות לחצן התקנה היא רק אחת מהדרכים שבהן המשתמשים יכולים להתקין אותה. הם יכולים גם להשתמש בתפריט של Chrome, בסרגל המידע הקטן ובסמל בסרגל הכתובות. כדי לעקוב אחרי כל הדרכים האלה להתקנה, אפשר להאזין לאירוע appinstalled.

  1. מוסיפים גורם מטפל באירועים מסוג appinstalled לאובייקט window.
  2. מתעדים את אירוע ההתקנה בכלי לניתוח נתונים או במנגנון אחר.

קוד:

window.addEventListener('appinstalled', (event) => {
  console.log('👍', 'appinstalled', event);
  // Clear the deferredPrompt so it can be garbage collected
  window.deferredPrompt = null;
});

קריאה נוספת

מזל טוב, עכשיו אפשר להתקין את האפליקציה.

הנה עוד כמה דברים שאפשר לעשות: