کلاس google.script.host (API سمت مشتری)

google.script.host یک API جاوا اسکریپت سمت کلاینت ناهمزمان است که می‌تواند با دیالوگ‌ها یا نوارهای فرعی در Google Docs، Sheets یا Forms که حاوی صفحات سرویس HTML هستند تعامل داشته باشد. برای اجرای توابع سمت سرور از کد سمت سرویس گیرنده، از google.script.run استفاده کنید. برای اطلاعات بیشتر به راهنمای ارتباط با توابع سرور در سرویس HTML مراجعه کنید.

خواص

اموال توضیحات
origin دامنه میزبان را فراهم می کند، بنابراین اسکریپت ها می توانند مبدا خود را به درستی تنظیم کنند.

روش ها

روش نوع برگشت شرح مختصر
close() void گفتگو یا نوار کناری فعلی را می بندد.
editor.focus() void فوکوس مرورگر را از کادر گفتگو یا نوار کناری به ویرایشگر Google Docs، Sheets یا Forms تغییر می‌دهد.
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 Docs، Sheets یا Forms تغییر می‌دهد.

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

پارامترها

نام تایپ کنید توضیحات
height Integer ارتفاع جدید، بر حسب پیکسل

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

پارامترها

نام تایپ کنید توضیحات
width Integer عرض جدید، بر حسب پیکسل