Класс google.script.host (клиентский API)

google.script.host — это асинхронный клиентский API JavaScript, который может взаимодействовать с диалоговыми окнами или боковыми панелями в Документах, Таблицах или Формах Google, содержащих страницы служб HTML . Чтобы выполнить функции на стороне сервера из кода на стороне клиента, используйте google.script.run . Дополнительные сведения см. в руководстве по взаимодействию с серверными функциями в службе HTML.

Характеристики

Свойство Описание
origin Предоставляет домен хоста, чтобы сценарии могли правильно установить свое происхождение.

Методы

Метод Тип возврата Краткое описание
close() void Закрывает текущий диалог или боковую панель.
editor.focus() void Переключает фокус браузера с диалогового окна или боковой панели на редактор Google Docs, Sheets или Forms.
setHeight(height) void Устанавливает высоту текущего диалога.
setWidth(width) void Устанавливает ширину текущего диалога.

Подробная документация

close()

Закрывает текущий диалог или боковую панель.

Код.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);
}

Индекс.html

<input type="button" value="Close"
  onclick="google.script.host.close()" />

editor.focus()

Переключает фокус браузера с диалогового окна или боковой панели на редактор Google Docs, Sheets или Forms.

Код.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);
}

Индекс.html

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

setHeight(height)

Устанавливает высоту текущего диалога.

Код.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');
}

Индекс.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)" />

Параметры

Имя Тип Описание
height Integer новая высота в пикселях

setWidth(width)

Устанавливает ширину текущего диалога.

Код.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');
}

Индекс.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)" />

Параметры

Имя Тип Описание
width Integer новая ширина в пикселях