מדריך הסגנון לממשק המשתמש של תוספים ל-Google Workspace

התוספים ל-Google Workspace צריכים להיות תואמים ל הסגנון והפריסה של אפליקציה מארחת הם נמשכים. הן צריכות להרחיב את ממשק המשתמש באופן טבעי באמצעות אמצעי בקרה והתנהגויות מוכרים. ההנחיות שהוצגו כאן מתארים דרכים לטיפול בטקסט, בתמונות, באמצעי בקרה ובמיתוג חוויית משתמש באיכות גבוהה.

אם התוסף פותח דפי אינטרנט נפרדים שהם חלק בלתי נפרד פעולה (כמו דף הגדרות של התוסף), צריך לוודא שדפי האינטרנט האלה לעמוד גם בהנחיות הסגנון האלה.

טקסט ותמונות

הקטע הזה מסביר איך להשתמש בצורה נכונה בטקסט ובתמונות בתוסף שלכם.

שם התוסף

צריך להגדיר את שם התוסף בפרויקט שלו ומניפסט להגדיר את התוסף לפרסום. השם מופיע במקומות רבים, כמו Google Workspace Marketplace בכרטיסי מוצר ובתפריטים. כשבוחרים שם:

  • שימוש באות גדולה בתחילת כל מילה.
  • יש להימנע מסימני פיסוק, במיוחד מסוגריים, אלא אם הם חלק מהמותג.
  • השם צריך להיות קצר — מומלץ 15 תווים או פחות. שמות ארוכים יכולים להיות נחתך באופן אוטומטי בדף האפליקציה ב-Google Workspace Marketplace ובמקומות אחרים.
  • אסור לכלול את המילים Google , Gmail או שמות של מוצרים אחרים של Google בשם התוסף.
  • אסור לכלול את המילה "תוסף". בשם התוסף.
  • אין לכלול את פרטי הגרסה.

סגנון כתיבה

לא צריך לכתוב הרבה. רוב הפעולות צריכות להיות ברורות באמצעות איקונוגרפיה, פריסה ותוויות קצרות. אם יש חלק מהתוסף דורש הסבר מקיף יותר ממה שתוויות קצרות יכולות לספק, להתאמן כדי ליצור דף אינטרנט נפרד שמתאר את התוסף שלכם ולקשר אליו.

כשכותבים טקסט בממשק משתמש:

  • חשוב להשתמש באות גדולה בתחילת המשפט (במיוחד כשמדובר בלחצנים, בתוויות ובפעולות בכרטיס).
  • יש להעדיף טקסט קצר ופשוט, ללא מונחים מקצועיים או ראשי תיבות.

פעולות אוניברסליות ופעולות בכרטיס

אם משתמשים בפעולות אוניברסליות או פעולות בכרטיסים תוספים, הם מופיעים כאפשרויות בתפריט בכרטיסים שאתם מגדירים. אפשר לבחור את הטקסט שישמש בתפריטים האלה פעולות. כשבוחרים את הטקסט שבו רוצים להשתמש:

  • חשוב להימנע מטקסט שחוזר על עצמו באמצעות שם התוסף.
  • להתחיל כל אפשרות בתפריט במילת פעולה כמו 'הפעלה', 'הגדרה' או 'יצירה'.
  • צריך לתאר את המשימה, לא את הרכיב בממשק המשתמש שמוצג בפעולה.
  • אם הפעולה מתחילה תהליך עבודה ואין פועל אחד שמתאר מה שהיא עושה, קוראים לזה "Start".
  • מומלץ לצמצם את מספר האפשרויות בתפריט כדי שהמשתמשים לא ייגללו דרך רשימה גדולה. אם יש עוד פעולות להטמעה, כדאי להשתמש מספר כרטיסים עם פעולות שונות בכל אחד.

הודעות שגיאה

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

  • אל תאפשר למשתמש לראות חריגות שהקוד שלך זורק. במקום זאת, להשתמש בהצהרות try...catch כדי ליירט חריגים, ואז להציג הודעת שגיאה ידידותית למשתמש.
  • לפני הפרסום, חשוב לוודא שהתוסף לא מציג מידע על תוצאות ניפוי הבאגים בממשק המשתמש.

תוכן עזרה

מומלץ לעצב כרטיסים שמציגים מידע עזרה או מסבירים פעולת התוסף למשתמש. אם אתם יוצרים תוכן עזרה עבור תוסף, הקפידו:

  • כשאפשר, הצג את ההוראות ברשימה ממוספרת או ברשימת תבליטים. משתמשי הליכה עד לתוצאה הסופית, עם הפניות ברורות לרכיבים בעלי שם בממשק המשתמש.
  • חשוב לוודא שההוראות מסבירות בבירור את הדרישות, כמו הגדרת המוצר בגיליון אלקטרוני בצורה מסוימת.
  • אפשר להוסיף קישורים לתוכן עזרה חיצוני, כמו דפי אינטרנט שתומכים בך.

תמונות

התמונות שמופיעות בתוסף הן אחת סוגי סמלים מובנים או תמונה באירוח ציבורי שצוינה על ידי כתובת URL. כשמשתמשים בתמונות מתארחות, עליכם לוודא שהם נגישים לכל מי שמשתמש בתוסף.

פקדים

בקטע הזה מוצגות ההנחיות בנושא חוויית המשתמש ווידג'טים אינטראקטיביים.

לחצנים

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

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

DecoratedText

ווידג'טים של טקסט מעוצב מאפשרות להציג תוכן טקסט עם סמלים, לחצנים או מתגים.

  • בתוכן הטקסט, חשוב להשתמש באות גדולה בתחילת המשפט (באנגלית).
  • הטקסט של ווידג'ט DesignatedText נחתך אם הוא לא יכול להתאים שטח פנוי פנוי. לכן, נסו תמיד להשאיר את תוכן הטקסט כפי שהוא כמה שיותר מהר.

מקורות קלט שנבחרו

אפשר להשתמש ווידג'טים לקלט הבחירה בתוסף: תיבות בחירה נפתחות, תיבות סימון ולחצני בחירה.

  • אפשר להשתמש בתיבות סימון כשאנשים יכולים לבחור כמה אפשרויות, או לא לבחור אף אפשרות. השתמש בלחצני בחירה (או בתפריט בחירה) כאשר יש לבחור רק אפשרות אחת. השתמשו בתפריטים נפתחים כשאתם מספקים רשימה קצרה של חלופות, כשאתם מנסים כדי לחסוך מקום בממשק המשתמש.
  • הטקסט שמוקצה לכל אפשרות צריך להיות אות גדולה בתחילת הטקסט.
  • הימנעו משימוש בשינויי בחירה כדי להפעיל פעולות גדולות שקשות להיפוך, כי הרבה פעמים אנשים טועים כשהם בוחרים לבחור. במקום זאת, כדאי הוספת לחצן שקורא את ערכי הבחירה הנוכחיים ואז מפעיל את הפעולה.
  • בתפריטים נפתחים, צריך למיין את האפשרויות בסדר אלפביתי או לפי סכמה לוגית שכל המשתמשים יכולים להבין (כמו הצגת ימי השבוע לפי הסדר, החל מיום ראשון או מיום שני).
  • הגבלת מספר האפשרויות בקלט בחירה נתון למספר סביר של ווידג'ט. אם יש יותר מדי אפשרויות, המשתמשים עלולים למצוא שקשה להשתמש בווידג'ט. במקרים כאלה, כדאי לנסות לשבור את האפשרות לקטגוריות שונות ולכמה ווידג'טים.

קלט של טקסט

קלט טקסט מספק למשתמשים מקום להזין נתוני מחרוזות.

  • לא להשתמש בקלט טקסט כדי שהמשתמש ייכתב כקלט של קבוצה ספציפית רשומות אפשריות. במקום זאת, אפשר להשתמש בתפריט נפתח.
  • השתמשו ברמזים ובהצעות כדי לעזור למשתמש להזין טקסט עם הפורמט והתוכן.
  • יש להשתמש בקלט טקסט מרובה שורות אם הטקסט שיש להזין כולל יותר מכמה שורות ולא של מילים בודדות,

מיתוג

בקטע הזה מוצגות הנחיות בנושא חוויית המשתמש להוספת רכיבי מיתוג לממשק התוסף.

בתוסף שלך

אם רוצים לכלול מיתוג בממשק המשתמש של התוסף, חשוב לבחור אותו קצר וקל. כך אנשים יוכלו להתמקד בפונקציונליות של התוספים שלך.

  • כל ההיבטים של התוסף חייבים לעמוד בדרישות הנחיות מיתוג.
  • אל תכללו את המילה 'Google', 'Gmail' או שמות של מוצרים אחרים של Google.
  • אל תכללו סמלים של מוצרי Google, גם אם הם עברו שינוי.
  • אסור לכלול את המילה "תוסף". בטקסט המיתוג שלכם.
  • טקסט מיתוג לא יכול לכלול יותר מכמה מילים.

ב-Google Workspace Marketplace

כשמגדירים את התוסף לפרסום, לספק כמה נכסי טקסט וגרפיקה כדי ליצור דף האפליקציה ב-Google Workspace Marketplace.

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