Classe google.script.host (API lato client)

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