זהו קטלוג של רכיבי ממשק משתמש שזמינים בתוספים. כל רשומה מכילה:
- תמונה של הרכיב (אם רלוונטי).
- תיאור של הייעוד שלו.
- רכיבי ממשק קשורים (אם רלוונטי).
- קישורים להוראות הטמעה ולדוגמאות קוד.
האלמנטים האלה הם דרכים שונות להפעלת תכונות של תוספים. אתם לא חייבים להטמיע את כל ההמלצות. למעשה, יכול להיות שבתרחישי שימוש מסוימים לא תהיה אפשרות להשתמש באף אחת מהן. לדוגמה, אפשר להשתמש במקש קיצור כדי להפעיל כלי לקיצור קישורים על כתובת ה-URL שמוצגת, ולהעתיק את הקישור המקוצר ללוח באופן אוטומטי.
פעולות
פעולה היא מה שקורה כשמשתמש לוחץ על סמל הפעולה של התוסף. פעולה יכולה להפעיל תכונה של תוסף באמצעות Action API או לפתוח חלון קופץ שמאפשר למשתמשים להפעיל כמה תכונות של תוסף. כדאי להשתמש בהסבר קצר כדי להסביר למשתמשים מה הפעולה עושה.
כדי ללמוד איך ליצור פעולה, אפשר לעיין במאמר הטמעת פעולה או לבדוק את דוגמאות הפעולות.
סמלי פעולות
תוסף צריך לפחות סמל אחד שייצג אותו. המשתמשים לוחצים על הסמל כדי להפעיל פעולה, בין אם הפעולה מפעילה תכונה של תוסף באמצעות Action API או פותחת חלון קופץ.
אפשר גם להוסיף לסמל תווית, שנקראת כאן 'תג', כדי להציג דברים כמו מצב התוסף או פעולות שנדרשות מהמשתמש.
כדי ללמוד איך ליצור פעולה, אפשר לעיין במאמר הטמעת פעולה או לבדוק את דוגמאות הפעולות.
תגים
תגים הם קטעי טקסט מעוצב שמוצבים מעל סמל הפעולה כדי לציין דברים כמו מצב התוסף או פעולות שנדרשות מהמשתמש. אפשר להגדיר את הטקסט של התג באמצעות הקריאה browser.action.setBadgeText() ואת צבע הבאנר באמצעות הקריאה browser.action.setBadgeBackgroundColor().
כדי ללמוד איך ליצור פעולה, אפשר לעיין במאמר הטמעת פעולה או בדוגמה שתיית מים.
פקודות
פקודות הן שילובים של מקשים שמפעילים תכונה של תוסף. מגדירים שילובי מקשים בקובץ manifest.json ומגיבים להם באמצעות Commands API.
כדי ללמוד איך להטמיע פקודה, אפשר לעיין במאמרי העזרה של ה-API או בדוגמה של browser.commands.
תפריט הקשר
תפריט הקשר מופיע בלחיצה המשנית (שנקראת לעיתים קרובות לחיצה ימנית) של העכבר. אפשר להגדיר תפריטי הקשר באמצעות Context Menus API.
כדי ללמוד איך להטמיע תפריט הקשר, אפשר לעיין בדוגמאות של תפריט הקשר.
סרגל הכתובות
אתם יכולים ליצור אינטראקציה עם משתמשים באמצעות תיבת הכתובות ב-Chrome. כשמשתמש מזין מילות מפתח שהוגדרו בתוסף בסרגל הכתובות, התוסף קובע מה המשתמש רואה בסרגל הכתובות. מגדירים מילות מפתח ב-manifest.json ומגיבים להן באמצעות Omnibox API.
כדי ללמוד איך לבטל את ההגדרה של סרגל הכתובות, אפשר לעיין בדוגמה בנושא הפעלת פעולות מסרגל הכתובות או במאמרי העזרה של ה-API המהירים.
שינוי דפים
תוסף יכול לבטל את אחת מההגדרות של דפי Chrome המובנים האלה:
- היסטוריה
- כרטיסייה חדשה
- סימניות
במאמר החלפת דפים ב-Chrome או בדוגמה override מוסבר איך להחליף דפים ב-Chrome.
חלונות קופצים
חלון קופץ הוא פעולה שפותחת חלון ומאפשרת למשתמשים להפעיל כמה תכונות של התוסף. אפשר לפתוח חלונות קופצים אם המשתמש לוחץ על סמל הפעולה, באמצעות מקש קיצור או על ידי קריאה ל-browser.action.openPopup().
במאמר הוספת חלון קופץ מוסבר איך ליצור חלון קופץ. אפשר גם להוריד שלב באמצעות אחת מדוגמאות הפעולה.
חלוניות צדדיות
חלונית צדדית מאפשרת למשתמשים להפעיל תכונות של תוספים לצד דפי אינטרנט (כמו שרואים בתמונה). אפשר לצרף חלונית צדדית לכרטיסייה אחת או לחלון שלם. השליטה בחלונית הצדדית מתבצעת באמצעות Side Panel API.
כדי ללמוד איך ליצור חלונית צדדית, אפשר לעיין בתרחישי השימוש בחלונית הצדדית או לבדוק את הדוגמאות לחלוניות צדדיות.
הסברים קצרים
כשמשתמש מעביר את העכבר מעל סמל הפעולה של התוסף, מופיע תיאור של הפעולה שהתוסף מבצע. כברירת מחדל, בתיבת הטיפ מופיע שם התוסף.
כדי ללמוד איך להוסיף תיאור קצר, משתמשים בחבר "default_title" של מפתח קובצי המניפסט "action".
כלי פיתוח
אתם יכולים להוסיף חלוניות מותאמות אישית (שנקראות כרטיסיות בכלי הפיתוח) לכלי הפיתוח באמצעות DevTools Panels API. ממשקי API אחרים של כלי הפיתוח מאפשרים לעקוב אחרי חלונות ותנועה ברשת. אפשר גם להתאים אישית את חלונית ההקלטה בכלי הפיתוח. החלונית Lighthouse בכלי הפיתוח ל-Chrome התחילה את דרכה כתוסף לכלי הפיתוח.
התראות
שליחת הודעות למגש המערכת של המשתמש באמצעות Notifications API של התוספים או Notifications API של פלטפורמות האינטרנט.
הוראות לשימוש בהתראות מופיעות במאמר הודעה למשתמשים.
עיצובים
עיצוב הוא סוג מיוחד של תוסף שמשנה את המראה של הדפדפן. ערכות נושא נארזות כמו תוספים רגילים, אבל הן לא מכילות קוד JavaScript או HTML.
כדי ללמוד איך ליצור נושא, אפשר לעיין במאמר מהם נושאים?.
דרכים אחרות ליצור אינטראקציה עם משתמשים
בקטע הזה מתוארות דרכים אחרות שבהן התוסף יכול ליצור אינטראקציה עם המשתמשים. הם לא נדרשים בהכרח לתוסף בסיסי, אבל הם יכולים להיות חלקים חשובים בתוסף. משתמשים רבים צריכים את חלק מהתכונות האלה כדי להשתמש בתוסף.
נגישות
עבור משתמשים רבים, הנגישות היא ממשק המשתמש, והתכונות שלה יכולות להיות שימושיות גם למי שלא צריך נגישות כאמצעי העיקרי לאינטראקציה עם התוסף. מידע בסיסי על הנגשת תוספים
אינטרנציונליזציה
לדבר עם משתמשים בשפה שלהם. איך מתאימים את הממשק לשפות שונות