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

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

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