الفئة google.script.host (واجهة برمجة تطبيقات من جهة العميل)

google.script.host هي واجهة برمجة تطبيقات JavaScript غير متزامنة من جهة العميل يمكنها التفاعل. باستخدام مربعات الحوار أو الأشرطة الجانبية في "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" التي تحتوي على صفحات خدمة HTML: لتنفيذ دوال جانب الخادم من رمز من جهة العميل، استخدِم google.script.run. لمزيد من المعلومات، يُرجى مراجعة الـ دليل التواصل مع وظائف الخادم في خدمة HTML.

أماكن إقامة

الموقعالوصف
originيوفر النطاق المضيف، حتى تتمكن النصوص البرمجية من تعيين المصدر بشكل صحيح.

الطُرق

الطريقةنوع الإرجاعوصف قصير
close() void إغلاق شريط الحوار أو الشريط الجانبي الحالي
editor.focus() void لتبديل تركيز المتصفّح من مربع الحوار أو الشريط الجانبي إلى أداة تعديل "مستندات Google" أو "جداول بيانات Google" أو "نماذج 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" أو "جداول بيانات Google" أو "نماذج 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العرض الجديد بالبكسل