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

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

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

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

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

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

function onOpen() {
  const 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 כך שהיא תדלג על התפריט בעתיד אם מוגדרת מאפיין מסוים.

תוספים של כלי העריכה יכולים לכלול גם פריטים בתפריט, אבל הם מוגדרים באמצעות כללים מיוחדים.

תמונות ושרטוטים קליקביליים ב-Sheets

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

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

function showMessageBox() {
  SpreadsheetApp.getUi().alert('You clicked it!');
}

1. חוזרים ל-Sheets ומוסיפים תמונה או שרטוט על ידי בחירה באפשרות הוספה > תמונה או הוספה > שרטוט.
2. אחרי שמוסיפים את התמונה או השרטוט, לוחצים עליהם. בפינה השמאלית העליונה מופיע תפריט נפתח קטן. לוחצים עליו ובוחרים באפשרות הקצאת סקריפט.
3. בתיבת הדו-שיח שמופיעה, מקלידים את השם של פונקציית Apps Script שרוצים להריץ, בלי סוגריים – במקרה הזה, showMessageBox. לוחצים על אישור.
4. לוחצים שוב על התמונה או השרטוט. הפונקציה מופעלת עכשיו.

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