In questa pagina di riferimento viene descritta l'API Intermediate iframe Support JavaScript, che consente di modificare l'iframe intermedio nell'esperienza utente successiva.
Per informazioni su come utilizzare iframe intermedi, consulta la guida Integrare un tocco con un iframe.
Nella tabella seguente sono elencati tutti i metodi disponibili e i relativi comportamenti.
| Metodi | |
|---|---|
verifyParentOrigin |
esegue la verifica dell'origine principale |
notifyParentClose |
comunica al frame principale che il flusso UX One Tap viene ignorato |
notifyParentDone |
comunica al frame principale che il flusso UX One Tap è terminato |
notifyParentResize |
comunica al frame principale di ridimensionare l'iframe intermedio |
notifyParentTapOutsideMode |
comunica al frame principale se annullare l'iframe intermedio quando l'utente fa clic al di fuori dell'iframe intermedio |
Carica la libreria JavaScript di supporto per iframe intermedio
Inserisci il seguente snippet di codice in qualsiasi pagina HTML in cui vuoi caricare l'iframe intermedio:
<script src="https://accounts.google.com/gsi/intermediatesupport"></script>
Metodo: google.accounts.id.intermediate.verifyParentOrigin
Il metodo google.accounts.id.intermediate.verifyParentOrigin esegue la verifica dell'origine principale. Vedi l'esempio di codice del metodo riportato di seguito:
google.accounts.id.intermediate.verifyParentOrigin(
origins, verifiedCallback, verificationFailedCallback)
L'esempio di codice seguente mostra come mostrare la UI solo dopo la verifica dell'origine padre:
<script>
window.onload = () => {
google.accounts.id.intermediate.verifyParentOrigin(
"https://example.com", showUI, showError);
};
</script>
Nella tabella seguente sono elencati i parametri:
| Parametro | |
|---|---|
origins |
Le origini autorizzate a incorporare l'iframe intermedio. |
verifiedCallback |
Il metodo di callback JavaScript attivato quando l'origine principale corrente può incorporare l'iframe intermedio. |
verificationFailedCallback |
Il metodo di callback JavaScript attivato quando l'origine principale corrente non è autorizzata a incorporare l'iframe intermedio. |
origini
Le origini autorizzate a incorporare l'iframe intermedio. Per ulteriori informazioni, consulta la seguente tabella:
| Tipo | Obbligatorio | Esempio |
|---|---|---|
| stringa, matrice di stringa o funzione | Facoltativo | allowed_parent_origin: "https://example.com" |
Nella tabella seguente sono elencati i tipi di valori supportati e le relative descrizioni.
| Tipi di valore | ||
|---|---|---|
string |
Un singolo URI di dominio. | "https://example.com" |
string array |
Un array di URI di dominio. | "https://news.example.com,https://local.example.com" |
callback verificato
Questo campo è un metodo di callback JavaScript attivato quando l'origine principale corrente può incorporare l'iframe intermedio.
verificaNon riuscitoRichiama
Questo campo è un metodo di callback JavaScript attivato quando l'origine principale corrente non è autorizzata a incorporare l'iframe intermedio.
Metodo: google.accounts.id.intermediate.notifyParentClose
Il metodo google.accounts.id.intermediate.notifyParentClose comunica al frame principale di chiudere l'iframe intermedio quando il flusso UX di One Tap viene ignorato. Vedi l'esempio di codice del metodo riportato di seguito:
google.accounts.id.intermediate.notifyParentClose()
Metodo: google.accounts.id.intermediate.notifyParentFatto
Il metodo google.accounts.id.intermediate.notifyParentClose comunica al frame principale di chiudere l'iframe intermedio e aggiornare lo stato di accesso. Vedi il seguente esempio di codice del metodo:
google.accounts.id.intermediate.notifyParentDone()
Metodo: google.accounts.id.intermediate.notifyParentResize
Il metodo google.accounts.id.intermediate.notifyParentResize comunica al frame principale di ridimensionare l'iframe intermedio. Vedi il seguente esempio di codice del metodo:
google.accounts.id.intermediate.notifyParentResize(height)
altezza
La nuova altezza in pixel. Questo campo è obbligatorio. Il valore deve essere un numero non negativo.
Se il parametro di altezza è maggiore di 0, l'iframe intermedio viene impostato sulla nuova altezza. Se il parametro di altezza è 0, l'iframe intermedio diventa invisibile. Un iframe nascosto non è chiuso. Può essere mostrato in un secondo momento da un'altra chiamata al metodo di ridimensionamento.
Metodo: google.accounts.id.intermediate.notifyParentTapOutsideMode
Il metodo google.accounts.id.intermediate.notifyParentTapOutsideMode indica al frame principale se annullare l'iframe intermedio quando l'utente fa clic al di fuori dell'iframe intermedio. Vedi l'esempio di codice del metodo riportato di seguito:
google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)
annulla
Questo valore booleano obbligatorio indica se annullare l'iframe intermedio quando l'utente fa clic al di fuori dell'iframe intermedio.