מאמרי עזרה על API של iframe ברמת ביניים

בדף העיון הזה מוסבר על Intermediate iframe API, שמשמש להטמעת ההנחיה 'הצטרפות בלחיצה אחת' בדפי אינטרנט באמצעות iframe.

מידע נוסף על עבודה עם iframes ביניים זמין במאמר שילוב של One Tap באמצעות iframe.

טעינת ספריית JavaScript של iframe ביניים

מציבים את קטע הקוד הבא בכל דף HTML שרוצים שיוצג ב-Google One בלחיצה:

<script src="https://accounts.google.com/gsi/intermediate"></script>

HTML API

אפשר לטעון את ה-iframe הביניים על ידי הוספת רכיב HTML עם מאפיין המזהה שמוגדר ל-g_id_intermediate_iframe. אפשר לעיין בקטע הקוד לדוגמה שבהמשך:

<script src="https://accounts.google.com/gsi/intermediate"></script>
<div id="g_id_intermediate_iframe"
     data-src="https://example.com/onetap_iframe.html">
</div>

רכיב עם המזהה g_id_intermediate_iframe

אפשר להציב את מאפייני הנתונים של ה-iframe הביניים בכל רכיב גלוי או בלתי נראה, כמו <div> ו-<span>. הדרישה היחידה היא שהמזהה של הרכיב מוגדר ל-g_id_intermediate_iframe. אל תציבו את המזהה הזה בכמה רכיבים.

בטבלה הבאה מפורטים מאפייני הנתונים והתיאורים שלהם:

data-src

המאפיין הזה הוא ה-URI של ה-iframe הביניים של One Tap. מידע נוסף מפורט בטבלה הבאה:

data-done

המאפיין הזה הוא פונקציית קריאה חוזרת של JavaScript שמופעלת כשממשק המשתמש של One Tap מסתיים.

כברירת מחדל, דף התוכן נטען מחדש כשהתהליך של ממשק המשתמש של One Tap מסתיים. אפשר לשנות את התנהגות ברירת המחדל באמצעות הגדרת קריאה חוזרת משלכם לציון סיום. מידע נוסף מפורט בטבלה הבאה:

‫JavaScript API

אפשר לטעון את ה-iframe של הביניים על ידי קריאה לשיטת JavaScript.

שיטה: google.accounts.id.initializeIntermediate

השיטה google.accounts.id.initializeIntermediate טוענת את ה-iframe הביניים על סמך אובייקט ההגדרה. דוגמה לקוד של השיטה:

google.accounts.id.initializeIntermediate(IntermediateConfig)

בדוגמה הבאה של קוד מוטמעת השיטה google.accounts.id.initializeIntermediate עם הפונקציה onload:

<script>
  window.onload = function () {
    google.accounts.id.initializeIntermediate({
      src: 'https://example.com/intermediate'
    });
  };
</script>

סוג הנתונים: IntermediateConfig

בטבלה הבאה מפורטים השדות והתיאורים שלהם:

src

בשדה הזה מזינים את ה-URI של ה-iframe הביניים של התכונה 'הצטרפות בלחיצה אחת'. מידע נוסף מפורט בטבלה הבאה:

סיום

השדה הזה הוא שיטת הקריאה החוזרת של JavaScript שמופעלת כשהממשק של One Tap מסתיים.

כברירת מחדל, דף התוכן נטען מחדש כשהתהליך של ממשק המשתמש של One Tap מסתיים. אפשר לשנות את התנהגות ברירת המחדל באמצעות הגדרת קריאה חוזרת משלכם לציון סיום. מידע נוסף מפורט בטבלה הבאה: