القوائم المخصّصة في Google Workspace

يمكن أن توسّع النصوص البرمجية بعض منتجات Google من خلال إضافة عناصر واجهة المستخدم التي، عند النقر عليها، يتم تنفيذ دالة برمجة تطبيقات Google. أحد الأمثلة الأكثر شيوعًا هو تشغيل نص برمجي من عنصر قائمة مخصّص في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"، ولكن يمكن أيضًا تشغيل وظائف النصوص البرمجية من خلال النقر على الصور والرسومات في "جداول بيانات Google".

القوائم المخصّصة في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"

يمكن أن تضيف "برمجة تطبيقات Google" قوائم جديدة في "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google"، مع ربط كل عنصر قائمة بدالة في البرنامج النصي. (في "نماذج Google"، لا تظهر القوائم المخصّصة إلا للمحرّر الذي يفتح النموذج لتعديله، وليس للمستخدم الذي يفتح النموذج للردّ عليه).

يمكن للنصوص البرمجية المرتبطة فقط إنشاء قوائم. لعرض القائمة عندما يفتح المستخدم ملفًا، اكتب رمز القائمة ضمن الدالة onOpen.

يوضّح المثال التالي كيفية إضافة قائمة تتضمّن عنصرًا واحدًا، يليه فاصل مرئي، ثم قائمة فرعية تتضمّن عنصرًا آخر. عندما يختار المستخدم أحد عناصر القائمة، تفتح دالة مقابلة مربّع حوار تنبيه. لمزيد من المعلومات حول أنواع مربّعات الحوار التي يمكنك فتحها، راجِع دليل مربّعات الحوار والأشرطة الجانبية.

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
      .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
      .alert('You clicked the second menu item!');
}

يمكن أن يحتوي المستند أو جدول البيانات أو العرض التقديمي أو النموذج على قائمة واحدة فقط تحمل اسمًا معيّنًا. إذا أضاف البرنامج النصي نفسه أو برنامج نصي آخر قائمة بالاسم نفسه، ستحلّ القائمة الجديدة محلّ القائمة القديمة. لا يمكن إزالة القوائم أثناء فتح الملف، ولكن يمكنك كتابة الدالة onOpen لتخطّي القائمة في المستقبل إذا تم ضبط سمة معيّنة.

يمكن أن تتضمّن إضافات المحرِّر عناصر قائمة أيضًا، ولكنها تستخدم قواعد خاصة لتحديد طريقة عملها.

الصور والرسومات القابلة للنقر في "جداول بيانات Google"

يمكنك أيضًا تعيين دالة في "برمجة تطبيقات Google" لصورة أو رسم في "جداول بيانات Google"، شرط أن يكون النص البرمجي مرتبطًا بجدول البيانات. يوضّح المثال التالي كيفية إعداد ذلك.

1. في "جداول بيانات Google"، انقر على عنصر القائمة الإضافات > برمجة التطبيقات لإنشاء نص برمجي مرتبط بجدول البيانات.
2. احذف أي رمز في أداة تعديل النصوص البرمجية وألصِق الرمز أدناه.

function showMessageBox() {
  SpreadsheetApp.getUi().alert('You clicked it!');
}

1. ارجع إلى "جداول بيانات Google" وأدرِج صورة أو رسمًا من خلال النقر على إدراج > صورة أو إدراج > رسم.
2. بعد إدراج الصورة أو الرسم، انقر عليه. يظهر أداة اختيار صغيرة لقائمة منسدلة في أعلى يسار الشاشة. انقر على الرمز واختَر تعيين نص برمجي.
3. في مربّع الحوار الذي يظهر، اكتب اسم دالة برمجة تطبيقات التي تريد تنفيذها بدون أقواس، أي showMessageBox في هذه الحالة. انقر على حسنًا.
4. انقر على الصورة أو الرسم مرة أخرى. يتم تنفيذ الدالة الآن.

لا يتم تشغيل النص البرمجي إلا من خلال النقر على الصورة أو الرسم في متصفّح الويب. لا يتم تنفيذ النص البرمجي إذا تم النقر على الصورة أو الرسم على الجهاز الجوّال.