يمكن أن تعرض النصوص البرمجية المرتبطة بـ "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" عدة أنواع من عناصر واجهة المستخدم، مثل التنبيهات والطلبات المنشأة مسبقًا، بالإضافة إلى مربّعات الحوار والأشرطة الجانبية التي تحتوي على صفحات خدمة HTML المخصّصة. عادةً ما يتم فتح هذه العناصر من عناصر القائمة. (يُرجى العلم أنّه في "نماذج Google"، لا تكون عناصر واجهة المستخدم مرئية إلّا للمحرِّر الذي يفتح النموذج لتعديله، وليس للمستخدم الذي يفتح النموذج للردّ عليه).
مربّعات حوار التنبيهات
التنبيه هو مربّع حوار مضمَّن مسبقًا يتم فتحه داخل أداة تحرير "مستندات Google" أو "جداول بيانات Google"
أو "العروض التقديمية من Google" أو "نماذج Google". يعرض رسالة وزر "موافق"؛ ويكون العنوان والأزرار البديلة اختيارية. وهو يشبه استدعاء
window.alert()
في JavaScript من جهة العميل داخل متصفح ويب.
تُعلّق التنبيهات النص البرمجي من جهة الخادم أثناء فتح مربع الحوار. يستأنف النص البرمجي بعد أن يغلق المستخدم مربّع الحوار، ولكن لا تستمر اتصالات JDBC خلال فترة التعليق.
كما هو موضح في المثال أدناه، تستخدم كل من "مستندات Google" و"نماذج Google" و"العروض التقديمية من Google"
و"جداول بيانات Google" الطريقة Ui.alert()
المتوفرة بثلاث خيارات مختلفة. لإلغاء زر "حسنًا" التلقائي، أدخِل قيمة من التعداد Ui.ButtonSet
كوسيطة buttons
. لتقييم الزر الذي نقر عليه المستخدم، قارِن
القيمة المعروضة لـ alert()
بتعداد
Ui.Button
.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show alert', 'showAlert')
.addToUi();
}
function showAlert() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.alert(
'Please confirm',
'Are you sure you want to continue?',
ui.ButtonSet.YES_NO);
// Process the user's response.
if (result == ui.Button.YES) {
// User clicked "Yes".
ui.alert('Confirmation received.');
} else {
// User clicked "No" or X in the title bar.
ui.alert('Permission denied.');
}
}
مربّعات حوار الطلبات
الطلب هو مربّع حوار مصمم مسبقًا يتم فتحه داخل أداة تحرير "مستندات Google" أو "جداول بيانات Google"
أو "العروض التقديمية من Google" أو "نماذج Google". ويعرض رسالة وحقل إدخال نص وزر "حسنًا"؛ أما العنوان والأزرار البديلة، فهي اختيارية. وهو يشبه استدعاء
window.prompt()
في JavaScript من جهة العميل داخل متصفح ويب.
تؤدي الطلبات إلى تعليق النص البرمجي من جهة الخادم عندما يكون مربّع الحوار مفتوحًا. يستأنف النص البرمجي بعد أن يغلق المستخدم مربّع الحوار، ولكن لا تستمر اتصالات JDBC خلال فترة التعليق.
كما هو موضّح في المثال أدناه، تستخدم كل من "نماذج Google" و"العروض التقديمية من Google" و"جداول بيانات Google" الطريقة Ui.prompt()
المتوفرة بثلاث خيارات مختلفة. لإلغاء زر "حسنًا" التلقائي،
مرِّر قيمة من التعداد
Ui.ButtonSet
كوسيطة buttons
. لتقييم ردّ المستخدم، سجِّل
القيمة المعروضة لـ prompt()
، ثم استدعِ
PromptResponse.getResponseText()
لاسترداد البيانات التي أدخلها المستخدم، وقارن القيمة المعروضة لـ
PromptResponse.getSelectedButton()
بتعداد Ui.Button
.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show prompt', 'showPrompt')
.addToUi();
}
function showPrompt() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.prompt(
'Let\'s get to know each other!',
'Please enter your name:',
ui.ButtonSet.OK_CANCEL);
// Process the user's response.
var button = result.getSelectedButton();
var text = result.getResponseText();
if (button == ui.Button.OK) {
// User clicked "OK".
ui.alert('Your name is ' + text + '.');
} else if (button == ui.Button.CANCEL) {
// User clicked "Cancel".
ui.alert('I didn\'t get your name.');
} else if (button == ui.Button.CLOSE) {
// User clicked X in the title bar.
ui.alert('You closed the dialog.');
}
}
مربّعات الحوار المخصّصة
يمكن لمربع الحوار المخصص عرض واجهة مستخدم خدمة HTML داخل أداة تحرير المستندات أو جداول البيانات أو العروض التقديمية أو النماذج من Google.
لا تعلِّق مربعات الحوار المخصّصة النص البرمجي من جهة الخادم عندما يكون مربّع الحوار مفتوحًا.
يمكن للمكوِّن من جهة العميل إجراء استدعاءات غير متزامنة للنص البرمجي من جهة الخادم باستخدام واجهة برمجة التطبيقات google.script
API لواجهات خدمة HTML.
يمكن أن يتم إغلاق مربّع الحوار تلقائيًا عن طريق طلب الرمز google.script.host.close()
من جهة العميل في واجهة خدمة HTML. لا يمكن إغلاق مربّع الحوار من خلال واجهات أخرى،
بل المستخدم أو المستخدم وحده.
كما هو موضح في المثال أدناه، تستخدم كل من "مستندات Google" و"نماذج Google" و"العروض التقديمية من Google" و"جداول بيانات Google" الطريقة Ui.showModalDialog()
لفتح مربّع الحوار.
Code.gs
function onOpen() { SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .createMenu('Custom Menu') .addItem('Show dialog', 'showDialog') .addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Page') .setWidth(400) .setHeight(300); SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .showModalDialog(html, 'My custom dialog'); }
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
الأشرطة الجانبية المخصصة
يمكن للشريط الجانبي عرض واجهة مستخدم خدمة HTML داخل أداة تحرير "مستندات Google" و"نماذج Google" و"العروض التقديمية من Google" و"جداول بيانات Google".
لا تعلّق الأشرطة الجانبية النص البرمجي من جهة الخادم عندما يكون مربّع الحوار مفتوحًا. يمكن للمكوِّن من جهة العميل إجراء استدعاءات غير متزامنة للنص البرمجي من جهة الخادم باستخدام واجهة برمجة التطبيقات google.script
لواجهات خدمة HTML.
يمكن أن يتم إغلاق الشريط الجانبي تلقائيًا عن طريق طلب الرمز google.script.host.close()
من جهة العميل ضِمن واجهة خدمة HTML. لا يمكن إغلاق الشريط الجانبي من خلال واجهات أخرى،
ولكن من قبل المستخدم فقط أو نفسه.
كما هو موضّح في المثال أدناه، تستخدم كل من "مستندات Google" و"نماذج Google" و"العروض التقديمية من Google" و"جداول بيانات Google" الطريقة Ui.showSidebar()
لفتح الشريط الجانبي.
Code.gs
function onOpen() { SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .createMenu('Custom Menu') .addItem('Show sidebar', 'showSidebar') .addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Page') .setTitle('My custom sidebar'); SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .showSidebar(html); }
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
مربّعات حوار فتح الملفات
منتقي Google هو مربع حوار "فتح الملف" للمعلومات المخزنة في خوادم Google، بما في ذلك Google Drive وبحث الصور من Google وبحث الفيديو من Google والمزيد.
كما هو موضح في المثال أدناه، يمكن استخدام واجهة برمجة تطبيقات JavaScript من جهة العميل لـ Picker في خدمة HTML لإنشاء مربع حوار مخصص يتيح للمستخدمين اختيار الملفات الموجودة أو تحميل ملفات جديدة، ثم تمرير هذا التحديد مرة أخرى إلى النص البرمجي الخاص بك للاستخدام مرة أخرى.
لتمكين Picker والحصول على مفتاح واجهة برمجة التطبيقات، اتبع هذه الإرشادات:
- تأكَّد من أنّ مشروع النص البرمجي يستخدم مشروع Google Cloud Platform عادي.
- فعِّل Google Picker API في مشروعك على Google Cloud.
- عندما لا يزال مشروعك على Google Cloud مفتوحًا، اختَر واجهات برمجة التطبيقات والخدمات، ثم انقر على بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات. يؤدي هذا الإجراء إلى إنشاء المفتاح، ولكن يجب تعديل المفتاح لإضافة قيود التطبيق وقيود واجهة برمجة التطبيقات إلى المفتاح.
- في مربّع حوار مفتاح واجهة برمجة التطبيقات، انقر على إغلاق.
- بجانب مفتاح واجهة برمجة التطبيقات الذي أنشأته، انقر على رمز المزيد > تعديل مفتاح واجهة برمجة التطبيقات.
ضمن قيود التطبيقات، أكمل الخطوات التالية:
- اختر مُحيلات HTTP (المواقع الإلكترونية).
- ضمن القيود على المواقع الإلكترونية، انقر على إضافة عنصر.
- انقر على المُحيل وأدخِل
*.google.com
. - أضِف عنصرًا آخر وأدخِل
*.googleusercontent.com
كمُحيل. - انقر على تم.
ضمن قيود واجهة برمجة التطبيقات، أكمِل الخطوات التالية:
- اختَر تقييد المفتاح.
في القسم اختيار واجهات برمجة التطبيقات، اختَر Google Picker API وانقر على حسنًا.
ملاحظة: لا تظهر Google Picker API إلا إذا فعّلتها، لأنّ القائمة لا تعرض سوى واجهات برمجة التطبيقات التي تم تفعيلها للمشروع على السحابة الإلكترونية.
ضمن مفتاح واجهة برمجة التطبيقات، انقر على رمز النسخ إلى الحافظة .
في أسفل الشاشة، انقر على حفظ.