google.script.host
è un'API JavaScript lato client asincrona che può interagire con finestre di dialogo o barre laterali in Documenti, Fogli o Moduli Google che contengono pagine di servizio HTML. Per eseguire funzioni lato server dal codice lato client, utilizza google.script.run
. Per maggiori informazioni, consulta la guida alla comunicazione con le funzioni server nel servizio HTML.
Proprietà
Proprietà | Descrizione |
---|---|
origin | Fornisce il dominio host, in modo che gli script possano impostare correttamente la propria origine. |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
close() |
void |
Chiude la finestra di dialogo o la barra laterale corrente. |
editor.focus() |
void |
Cambia lo stato attivo del browser dalla finestra di dialogo o dalla barra laterale all'editor di Documenti, Fogli o Moduli Google. |
setHeight(height) |
void |
Imposta l'altezza della finestra di dialogo corrente. |
setWidth(width) |
void |
Imposta la larghezza della finestra di dialogo corrente. |
Documentazione dettagliata
close()
Chiude la finestra di dialogo o la barra laterale corrente.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Index'); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showSidebar(html); }
Index.html
<input type="button" value="Close" onclick="google.script.host.close()" />
editor.focus()
Cambia lo stato attivo del browser dalla finestra di dialogo o dalla barra laterale all'editor di Documenti, Fogli o Moduli Google.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Index'); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showSidebar(html); }
Index.html
<input type="button" value="Switch focus" onclick="google.script.host.editor.focus()" />
setHeight(height)
Imposta l'altezza della finestra di dialogo corrente.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Dialog').addItem('Show', 'showDialog').addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Index') .setWidth(300) .setHeight(200); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showModalDialog(html, 'Dialog title'); }
Index.html
<script> function resizeDialog(width, height) { google.script.host.setWidth(width); google.script.host.setHeight(height); } </script> <input type="button" value="Resize dialog" onclick="resizeDialog(450, 300)" />
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | la nuova altezza, in pixel. |
setWidth(width)
Imposta la larghezza della finestra di dialogo corrente.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Dialog').addItem('Show', 'showDialog').addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Index') .setWidth(300) .setHeight(200); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showModalDialog(html, 'Dialog title'); }
Index.html
<script> function resizeDialog(width, height) { google.script.host.setWidth(width); google.script.host.setHeight(height); } </script> <input type="button" value="Resize dialog" onclick="resizeDialog(450, 300)" />
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | la nuova larghezza, in pixel |