תפריטים מותאמים אישית ב-Google Workspace

סקריפטים יכולים להרחיב מוצרים מסוימים של Google על ידי הוספת רכיבי ממשק משתמש, שכאשר לוחצים עליהם, מפעילים פונקציית Apps Script. הדוגמה הנפוצה ביותר היא הרצת סקריפט מפריט בתפריט מותאם אישית ב-Google Docs , Sheets , Slides או Forms, אבל אפשר להפעיל פונקציות של סקריפט גם על ידי לחיצה על תמונות ושרטוטים ב-Google Sheets.

תפריטים מותאמים אישית ב-Google Docs , Sheets , Slides או Forms

באמצעות Apps Script אפשר להוסיף תפריטים חדשים ב-Google Docs, ב-Sheets, ב-Slides וב-Forms, כאשר כל פריט בתפריט מקושר לפונקציה בסקריפט. (ב-Google Forms, התפריטים המותאמים אישית גלויים רק למשתמש שפותח את הטופס כדי לשנות אותו, ולא למשתמש שפותח את הטופס כדי להשיב).

סקריפט יכול ליצור תפריט רק אם הוא מקושר למסמך, לגיליון האלקטרוני או לטופס. כדי להציג את התפריט כשהמשתמש פותח קובץ, כותבים את קוד התפריט בתוך פונקציה onOpen().

הדוגמה הבאה מראה איך להוסיף תפריט עם פריט אחד, ואחריו מפריד חזותי ואז תפריט משנה שמכיל פריט אחר. (שימו לב שב-Google Sheets, אלא אם משתמשים בגרסה החדשה, צריך להשתמש בתחביר addMenu() במקום זאת, ולא ניתן להשתמש בתפריטי משנה). כשהמשתמש בוחר באחת מהאפשרויות בתפריט, פונקציה מתאימה פותחת תיבת דו-שיח של alert. מידע נוסף על סוגי תיבות הדו-שיח שאפשר לפתוח זמין במדריך לתיבות דו-שיח ולסרגלי צד.

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 Sheets שאפשר ללחוץ עליהם

אפשר גם להקצות פונקציה של Apps Script לתמונה או לשרטוט ב-Google Sheets, כל עוד הסקריפט מקושר לגיליון האלקטרוני. הדוגמה הבאה מראה איך להגדיר את הפרמטר הזה.

1. ב-Google Sheets, בוחרים בתפריט תוספים > Apps Script, כדי ליצור סקריפט שמקשר לגיליון האלקטרוני.

2. מוחקים את הקוד בעורך הסקריפטים ומדביקים את הקוד שבהמשך.

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

3. חוזרים ל-Sheets ומוסיפים תמונה או שרטוט בלחיצה על Insert > Image (הוספה > תמונה) או Insert > Drawing (הוספה > שרטוט).

4. לאחר הוספת התמונה או השרטוט, לוחצים עליהם. בורר תפריט נפתח קטן מופיע בפינה השמאלית העליונה. לוחצים עליו ובוחרים באפשרות הקצאת הסקריפט.

5. בתיבת הדו-שיח שמופיעה, מקלידים את שם הפונקציה של Apps Script שרוצים להריץ, ללא סוגריים – במקרה הזה, showMessageBox. לוחצים על OK (אישור).

6. לוחצים שוב על התמונה או השרטוט. הפונקציה תופעל עכשיו.