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