google.script.host 類別 (用戶端 API)

google.script.host 是能與使用者互動的非同步用戶端 JavaScript API 含有對話方塊或側欄的 Google 文件、試算表或表單 HTML 服務網頁。如要執行 用戶端程式碼，請使用 google.script.run。若需更多資訊，請參閲 這個 與伺服器函式通訊的指南 。

屬性

屬性說明
origin提供主機網域，讓指令碼可以設定其 正確來源。

方法

方法傳回類型簡短說明
close() void 關閉目前的對話方塊或側欄。
editor.focus() void 將瀏覽器焦點從對話方塊或側欄切換至 Google 文件、試算表或表單編輯器。
setHeight(height) void 設定目前對話方塊的高度。
setWidth(width) void 設定目前對話方塊的寬度。

內容詳盡的說明文件

close()

關閉目前的對話方塊或側欄。

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()

將瀏覽器焦點從對話方塊或側欄切換至 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)

設定目前對話方塊的高度。

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)" />

參數

名稱類型說明
heightInteger新的高度 (以像素為單位)

setWidth(width)

設定目前對話方塊的寬度。

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)" />

參數

名稱類型說明
widthInteger新的寬度 (以像素為單位)