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

يمكن للنصوص البرمجية توسيع منتجات معينة من 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 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 or FormApp.
     .alert('You clicked the first menu item!');
}

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

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

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

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

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

1. في "جداول بيانات Google"، اختَر عنصر القائمة الإضافات > برمجة التطبيقات لإنشاء نص برمجي مرتبط بجدول البيانات.

2. احذف أي رمز في أداة تعديل النصوص البرمجية والصِقه في ما يلي.

     function showMessageBox() {
       Browser.msgBox('You clicked it!');
     }
   

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

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

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

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