התאמה אישית באמצעות תמונות

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

הערה: התכונה הזו זמינה בגרסה 4 ואילך של פורמט לוח השעון.

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

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

כדי להשתמש בתמונות בתצוגת השעון שהמשתמש יכול להגדיר, משתמשים ברכיב <PhotosConfiguration>. לדוגמה:

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

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

תמיכה בתמונה אחת

במקרה של תמונה אחת, אפשר להשתמש בתמונה בתוך רכיב PartImage באופן הבא:

<PartImage ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

שימו לב למאפיין defaultImageResource, שמופיע כשהמשתמש לא בחר תמונה באפליקציה הנלווית. זהו מאפיין חובה.

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

תמיכה בכמה תמונות

אם תלחצו על PhotosConfiguration ואז על configType="MULTIPLE", תוכלו להציג בשעון תמונה מאוסף. תוכלו לעבור בין התמונות בהקשה או באופן אוטומטי אחרי מספר צפיות מסוים.

<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
    source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>

בדוגמה הקודמת מוצגות שתי האפשרויות שמופיעות כשמשתמשים ב-MULTIPLE:

1. המאפיין change מאפשר למפתח לציין אילו אירועים יגרמו לתמונה לעבור בסבב בין התמונות הזמינות.

בדוגמה הקודמת, צוינו גם TAP וגם ON_VISIBLE, כלומר התמונה משתנה אם המשתמש מקייש עליה או בתגובה להצגת התמונה.

1. המאפיין changeAfterEvery חל רק על אירוע השינוי ON_VISIBLE, ומציין כמה פעמים התמונה אמורה הייתה להיות גלויה לפני שהיא השתנתה. לדוגמה, יכול להיות שתרגישו שהשינוי של התמונה בכל פעם שהמשתמש מעיר את השעון הוא תדיר מדי. ערך ברירת המחדל כאן הוא 3.

למידע נוסף על עבודה עם PhotosConfiguration, אפשר לעיין בדוגמאות ב-GitHub.