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
codice lato client, utilizza google.script.run
. Per ulteriori informazioni, vedi
il
guida alla comunicazione con le funzioni del server
nel servizio HTML.
Proprietà
Proprietà | Descrizione |
---|---|
origin | Indica il dominio host, in modo che gli script possano impostare dell'origine in modo corretto. |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
close() |
void |
Chiude la finestra di dialogo o la barra laterale corrente. |
editor.focus() |
void |
Sposta 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()
Sposta 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 |