Interfejs API JavaScript z obsługą elementów iframe dla średnio zaawansowanych

Na tej stronie znajdziesz opis interfejsu API JavaScript z obsługą średniozaawansowanego elementu iframe, który umożliwia obsługę pośredniego elementu iframe w kolejnych interfejsach użytkownika.

Aby dowiedzieć się, jak korzystać z pośrednich elementów iframe, przeczytaj przewodnik Integrowanie jednym dotknięciem za pomocą elementu iframe.

Poniższa tabela zawiera wszystkie dostępne metody i ich działania.

Metody
verifyParentOrigin	przeprowadza weryfikację źródła nadrzędnego
notifyParentClose	powiadamia ramkę nadrzędną, że procedura UX została pominięta
notifyParentDone	powiadamia o ramce nadrzędnej o zakończeniu procesu UX jednym dotknięciem
notifyParentResize	powiadamia ramkę nadrzędną o zmianie rozmiaru pośredniego elementu iframe
notifyParentTapOutsideMode	powiadamia ramkę nadrzędną, czy anulować pośredni element iframe, gdy użytkownik kliknie poza pośrednim elementem iframe.

Wczytywanie biblioteki JavaScript z obsługą średniozaawansowanych elementów iframe

Umieść ten fragment kodu na dowolnych stronach HTML, na których chcesz wczytywać pośredni element iframe:

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

Metoda: google.accounts.id.secondary.verifyParentOrigin

Metoda google.accounts.id.intermediate.verifyParentOrigin przeprowadza weryfikację nadrzędnego źródła. Zapoznaj się z przykładowym kodem tej metody:

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

Poniższy przykładowy kod pokazuje, jak wyświetlać interfejs użytkownika dopiero po zweryfikowaniu źródła nadrzędnego:

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

Lista parametrów znajduje się w tabeli poniżej:

Parametr
origins	Źródła, które mogą osadzać pośredni element iframe.
verifiedCallback	Metoda wywołania zwrotnego JavaScriptu wywoływana, gdy bieżący źródło nadrzędne może umieścić pośredni element iframe.
verificationFailedCallback	Metoda wywołania zwrotnego JavaScriptu wywoływana, gdy bieżący źródło nadrzędne nie może umieścić pośredniego elementu iframe.

źródła

Źródła, które mogą osadzać pośredni element iframe. Więcej informacji znajdziesz w tej tabeli:

Typ	Wymagany	Przykład
string, tablica ciągów lub funkcja	Opcjonalnie	allowed_parent_origin: "https://example.com"

W tabeli poniżej znajdziesz obsługiwane typy wartości i ich opisy.

Typy wartości
string	Pojedynczy identyfikator URI domeny.	„https://example.com”
string array	Tablica identyfikatorów URI domeny.	„https://news.example.com,https://local.example.com”

Uwaga: ciąg znaków zawierający identyfikatory URI rozdzielone przecinkami jest nieprawidłowy. Użyj obiektu tablicy JavaScript.

zweryfikowane połączenie zwrotne

To pole to metoda wywołania zwrotnego JavaScriptu, która jest uruchamiana, gdy bieżący źródło nadrzędne może umieścić pośredni element iframe.

weryfikacjaNieudane wywołanie zwrotne

To pole to metoda wywołania zwrotnego JavaScriptu, która jest uruchamiana, gdy bieżący źródło nadrzędne nie może umieścić pośredniego elementu iframe.

Ostrzeżenie: jeśli strona z treścią nie odpowie na prośbę o weryfikację domeny, proces weryfikacji będzie czekać w nieskończoność. W tym przypadku nie jest wywoływane ani verifiedCallback, ani verificationFailedCallback.

Metoda: google.accounts.id.secondary.notifyParentClose

Metoda google.accounts.id.intermediate.notifyParentClose powiadamia ramkę nadrzędną o zamknięciu pośredniego elementu iframe w przypadku pominięcia interfejsu użytkownika One Tap. Zapoznaj się z przykładowym kodem tej metody:

google.accounts.id.intermediate.notifyParentClose()

Metoda: google.accounts.id.completion.notifyParentDone

Metoda google.accounts.id.intermediate.notifyParentClose powiadamia ramkę nadrzędną, aby zamykała pośredni element iframe i odświeżał stan logowania. Zapoznaj się z tym przykładowym kodem metody:

google.accounts.id.intermediate.notifyParentDone()

Metoda: google.accounts.id.completion.notifyParentResize

Metoda google.accounts.id.intermediate.notifyParentResize powiadamia ramkę nadrzędną, by zmienić rozmiar pośredniego elementu iframe. Zapoznaj się z poniższym przykładowym kodem metody:

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

Uwaga: nie można zmienić szerokości pośredniego elementu iframe.

wysokość

Nowa wysokość w pikselach. To pole jest wymagane. Wartość musi być liczbą nieujemną.

Jeśli parametr wysokości jest większy niż 0, pośredni element iframe zostaje ustawiony na nową wysokość. Jeśli parametr wysokości ma wartość 0, pośredni element iframe staje się niewidoczny. Ukryty element iframe nie jest zamknięty. Można ją wyświetlić później przez inne wywołanie metody zmiany rozmiaru.

Metoda: google.accounts.id.ewentualnych.notifyParentTapOutsideMode

Metoda google.accounts.id.intermediate.notifyParentTapOutsideMode powiadamia ramkę nadrzędną, czy anulować pośredni element iframe, gdy użytkownik kliknie element poza pośrednim elementem iframe. Zapoznaj się z przykładowym kodem tej metody:

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

anuluj

Ta wymagana wartość logiczna wskazuje, czy ma anulować pośredni element iframe, gdy użytkownik kliknie element poza pośrednim elementem iframe.