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

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

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

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

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

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

function onOpen() {
  var 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() {
       Browser.msgBox('You clicked it!');
     }
   

3. ارجع إلى "جداول بيانات Google" وأدرِج صورة أو رسمًا عن طريق اختيار إدراج > صورة أو إدراج > رسم.

4. بعد إدراج الصورة أو الرسم، انقر عليه. ستظهر محدد قائمة منسدلة صغير في الزاوية اليمنى العلوية. انقر عليه واختر تعيين النص البرمجي.

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

6. انقر على الصورة أو الرسم مرة أخرى. يتم تنفيذ الدالة الآن.