קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תוספים ל-Editor שפורסמו יכולים ליצור פריטים מותאמים אישית בתפריט Extensions של Editor. אפשר להוסיף תפריט של תוסף באמצעות השיטה Ui.createAddonMenu() ולהוסיף לו פריטים באמצעות השיטה Menu.addItem(). בדרך כלל יוצרים תפריטים בשיטה onOpen(e) של התוסף.
אתם יכולים ליצור תפריטים דינמיים שמשתנים על סמך אינטראקציות של משתמשים או מצב התוסף. עם זאת, התוספים צריכים ליצור תפריט ראשוני לפני שהמשתמש מאשר את התוסף. לכן, לפני שיוצרים תפריטים ב-onOpen(e), צריך לבדוק את מצב ההרשאה של התוסף. אל תנסו לבצע פעולה כלשהי שנדרשת לה הרשאה (למשל, בדיקת הסקריפט Properties) בזמן שהתוסף נמצא במצב ScriptApp.AuthMode.NONE. לפרטים נוספים על מצבי ההרשאה ומחזור החיים שלה, אפשר לעיין במאמר בנושא מחזור החיים של ההרשאה.
בדוגמה הבאה אפשר לראות איך יוצרים תפריט דינמי של תוסף למצבי הרשאה שונים:
functiononOpen(e){varmenu=SpreadsheetApp.getUi().createAddonMenu();//OrDocumentApporSlidesApporFormApp.if(e && e.authMode==ScriptApp.AuthMode.NONE){//Addanormalmenuitem(worksinallauthorizationmodes).menu.addItem('Start workflow','startWorkflow');}else{//Addamenuitembasedonproperties(doesn't work in AuthMode.NONE).varproperties=PropertiesService.getDocumentProperties();varworkflowStarted=properties.getProperty('workflowStarted');if(workflowStarted){menu.addItem('Check workflow status','checkWorkflow');}else{menu.addItem('Start workflow','startWorkflow');}//Recordanalytics.UrlFetchApp.fetch('http://www.example.com/analytics?event=open');}menu.addToUi();}
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-31 (שעון UTC)."],[],["Editor add-ons create custom menu items under the **Extensions** menu using `Ui.createAddonMenu()` and `Menu.addItem()`, typically within the `onOpen(e)` method. Menus must be defined *before* user authorization, necessitating a check of the add-on's authorization mode. Dynamic menus can change based on user interactions. Actions requiring authorization should not be performed when `AuthMode.NONE`. The provided example shows a dynamic menu construction for different modes, adding either \"Start workflow\" or \"Check workflow status\".\n"]]