API JavaScript Dukungan Iframe Menengah

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Halaman referensi ini menjelaskan Intermediate Iframe Support JavaScript API, yang memungkinkan Anda memanipulasi iframe perantara di UX berikutnya.

Tabel berikut mencantumkan semua metode yang tersedia serta perilakunya.

Metode
verifyParentOrigin melakukan verifikasi asal induk
notifyParentClose memberi tahu frame induk bahwa alur UX Sekali Ketuk dilewati
notifyParentDone memberi tahu frame induk bahwa alur UX Sekali Ketuk selesai
notifyParentResize memberi tahu frame induk untuk mengubah ukuran iframe perantara
notifyParentTapOutsideMode memberi tahu frame induk apakah akan membatalkan iframe perantara saat pengguna mengklik di luar iframe perantara

Memuat Library JavaScript Dukungan Iframe Menengah

Tempatkan cuplikan kode berikut ke setiap halaman HTML tempat Anda ingin memuat iframe perantara:

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

Metode: google.accounts.id.intermediate.verifyParentOrigin

Metode google.accounts.id.intermediate.verifyParentOrigin melakukan verifikasi asal induk. Lihat contoh kode berikut dari metode tersebut:

google.accounts.id.intermediate.verifyParentOrigin(
    origins, verifiedCallback, verificationFailedCallback)

Contoh kode berikut menunjukkan cara menampilkan UI hanya setelah asal induk diverifikasi:

<script>
  window.onload = () => {
    google.accounts.id.intermediate.verifyParentOrigin(
        "https://example.com", showUI, showError);
  };
</script>

Tabel berikut mencantumkan parameter:

Parameter
origins Asal yang diizinkan untuk menyematkan iframe perantara.
verifiedCallback Metode callback JavaScript yang akan dipicu saat asal induk saat ini diizinkan untuk menyematkan iframe perantara.
verificationFailedCallback Metode callback JavaScript yang akan dipicu saat asal induk saat ini tidak diizinkan untuk menyematkan iframe perantara.

asal

Asal yang diizinkan untuk menyematkan iframe perantara. Lihat tabel berikut untuk informasi selengkapnya:

Jenis Wajib Contoh
string, array string, atau fungsi Opsional allowed_parent_origin: "https://example.com"

Tabel berikut mencantumkan jenis nilai yang didukung dan deskripsinya.

Jenis Nilai
string URI domain tunggal. "https://example.com"
string array Array URI domain. "https://news.example.com,https://local.example.com"

callback terverifikasi

Kolom ini adalah metode callback JavaScript yang akan dipicu saat asal induk saat ini diizinkan untuk menyematkan iframe perantara.

verificationFailedCallback

Kolom ini adalah metode callback JavaScript yang akan dipicu saat asal induk saat ini tidak diizinkan untuk menyematkan iframe perantara.

Metode: google.accounts.id.intermediate.notifyParentClose

Metode google.accounts.id.intermediate.notifyParentClose memberi tahu frame induk untuk menutup iframe perantara saat alur UX Sekali Ketuk dilewati. Lihat contoh kode berikut dari metode tersebut:

google.accounts.id.intermediate.notifyParentClose()

Metode: google.accounts.id.intermediate.notifyParentDone

Metode google.accounts.id.intermediate.notifyParentClose memberi tahu frame induk untuk menutup iframe perantara, dan memuat ulang status login. Lihat contoh kode berikut dari metode tersebut:

google.accounts.id.intermediate.notifyParentDone()

Metode: google.accounts.id.intermediate.notifyParentResize

Metode google.accounts.id.intermediate.notifyParentResize memberi tahu frame induk untuk mengubah ukuran iframe perantara. Lihat contoh kode berikut dari metode ini:

google.accounts.id.intermediate.notifyParentResize(height)

tinggi

Tinggi baru dalam piksel. Bidang ini harus diisi. Nilainya harus berupa angka yang tidak negatif.

Jika parameter tinggi lebih besar dari 0, iframe menengah akan ditetapkan ke tinggi baru. Jika parameter tingginya 0, iframe perantara akan tidak terlihat. iframe tersembunyi tidak ditutup. Ini dapat ditampilkan nanti dengan panggilan metode pengubahan ukuran lainnya.

Metode: google.accounts.id.intermediate.notifyParentTapOutsideMode

Metode google.accounts.id.intermediate.notifyParentTapOutsideMode memberi tahu frame induk apakah akan membatalkan iframe perantara saat pengguna mengklik di luar iframe perantara. Lihat contoh kode berikut dari metode ini:

google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)

batal

Nilai boolean yang diperlukan ini menunjukkan apakah akan membatalkan iframe perantara saat pengguna mengklik di luar iframe perantara.