الفئة 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

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

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

المعلمات

الاسمالنوعالوصف
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

المعلمات

الاسمالنوعالوصف
widthIntegerالعرض الجديد بالبكسل