תפריטים מותאמים אישית ב-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(), ולא ניתן ליצור תפריטי משנה). כשהמשתמש בוחר באחד מפריטי התפריט, הפונקציה המתאימה פותחת תיבת דו-שיח של התראה. למידע נוסף על סוגי תיבות הדו-שיח שאפשר לפתוח, קראו את המדריך לתיבת דו-שיח ולסרגל צד.

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 ומוסיפים תמונה או שרטוט על ידי בחירה באפשרות הוספה > תמונה או הוספה > שרטוט.

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

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

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