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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يمكن للنصوص البرمجية توسيع بعض منتجات Google من خلال إضافة عناصر واجهة المستخدم تعمل عند النقر على وظيفة "برمجة تطبيقات 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 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"، اختَر عنصر القائمة الإضافات & gt؛ برمجة تطبيقات Google لإنشاء نص برمجي مرتبط بجدول البيانات.
  2. احذِف أي رمز في محرِّر النص البرمجي والصقه في الرمز أدناه.
    function showMessageBox() {
    Browser.msgBox('You clicked it!');
    }
  3. ارجع إلى "جداول بيانات Google" وأدخِل صورة أو رسمًا من خلال النقر على Insert > Image أو Insert > Draws.
  4. بعد إدراج الصورة أو الرسم، انقر عليها. وستظهر قائمة منسدلة صغيرة في أعلى يسار الصفحة. انقر عليه واختَر تخصيص نص برمجي.
  5. في مربّع الحوار الذي يظهر، اكتب اسم دالة "برمجة التطبيقات" التي تريد تشغيلها بدون قوسين، وفي هذه الحالة، showMessageBox. انقر على حسنًا.
  6. انقر على الصورة أو الرسم مرة أخرى. سيتم تنفيذ الدالة الآن.

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

  1. في موقع مصمم في مواقع Google، انقر على المزيد &gt؛ إدارة الموقع الإلكتروني.
  2. في الشريط الجانبي، انقر على برمجة التطبيقات، ثم إضافة نص برمجي جديد لإنشاء نص برمجي مرتبط بالموقع الإلكتروني.
  3. يمكنك حذف أي رمز في محرِّر النص البرمجي ولصقه في الرمز أدناه، ما سيؤدي إلى إرسال رسالة إلكترونية عندما ينقر المستخدم على رابط.
    function sitesLink() {
    var recipient = Session.getActiveUser().getEmail();
    GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
    }
  4. الرجوع إلى موقع Google وتعديل الصفحة. اكتب تصنيفًا سيصبح رابطًا، مثل Click me، ثم حدّد النص وانقر على إدراج &gt؛ رابط.
  5. في مربع الحوار الذي يظهر، انقر على برمجة التطبيقات، ثم انقر على الدالة sitesLink التي أنشأتها للتو. انقر على حسنًا.
  6. انقر على حفظ في أعلى الصفحة.
  7. انقر على الرابط الذي أضفته إلى الصفحة.
  8. سيظهر مربّع حوار يخبرك بأن النص البرمجي يتطلب التفويض. انقر على حسنًا. بعد ذلك، سيطلب منك مربّع حوار ثانٍ الحصول على تفويض لخدمات Google معيّنة. اقرأ الإشعار بعناية، ثم انقر على السماح، ثم إغلاق.
  9. والآن بعد تفويض النص البرمجي، انقر على الرابط الذي أضفته إلى الصفحة مرة أخرى. سيتم تنفيذ الدالة الآن. يُرجى التحقّق من بريدك الإلكتروني للاطّلاع على الرسالة الإلكترونية التي أرسلتها بنفسك.