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