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.

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:

źródła

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

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

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.

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)

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.