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 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.gsIndex.html

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);
}

<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.gsIndex.html

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);
}

<input type="button" value="Switch focus"
  onclick="google.script.host.editor.focus()" />

---

setHeight(height)

Imposta l'altezza della finestra di dialogo corrente.

Code.gsIndex.html

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');
}

<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.gsIndex.html

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');
}

<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