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
originIndica il dominio host, in modo che gli script possano impostare dell'origine in modo corretto.

Metodi

MetodoTipo restituitoBreve 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

NomeTipoDescrizione
heightIntegerla 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

NomeTipoDescrizione
widthIntegerla nuova larghezza, in pixel