הסבר קצר הוא הודעה תיאורית קטנה שמופיעה ליד התצוגה כשמשתמשים ללחוץ לחיצה ארוכה על התצוגה או להעביר מעליה את העכבר. האפשרות הזו שימושית כשהאפליקציה שלך משתמש בסמל כדי לייצג פעולה או קטע מידע כדי לחסוך מקום הפריסה שלו. בדף הזה מוסבר איך להוסיף את ההסברים הקצרים האלה ב-Android 8.0 (רמת API) 26) ומעלה.
לתרחישים מסוימים, כמו תרחישים באפליקציות פרודוקטיביות, נדרשת שיטה תיאורית. להעברת רעיונות ופעולות. אפשר להשתמש בהסברים קצרים כדי להציג של ההודעה התיאורית, כפי שמוצג באיור 1.
איור 1. הסבר קצר מוצג באפליקציה ל-Android.
חלק מהווידג'טים הרגילים מציגים הסברים קצרים שמבוססים על התוכן של title או
content description נכסים. החל מ-Android 8.0, ניתן לציין את
טקסט שמוצג בהסבר הקצר ללא קשר לערך של נכסים אחרים.
הגדרת הטקסט של ההסבר הקצר
אפשר לציין את הטקסט של ההסבר הקצר ב-View באמצעות
setTooltipText(). אפשר להגדיר
המאפיין tooltipText באמצעות מאפיין ה-XML או ה-API המתאימים.
כדי לציין את הטקסט של ההסבר הקצר בקובצי XML, צריך להגדיר את המאפיין android:tooltipText כמו שמוצג
בדוגמה הבאה:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
כדי לציין את הטקסט של ההסבר הקצר בקוד, צריך להשתמש בשיטה setTooltipText(CharSequence), כמו בדוגמה הבאה:
Kotlin
val fab: FloatingActionButton = findViewById(R.id.fab) fab.tooltipText = "Send an email"
Java
FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); fab.setTooltipText("Send an email");
ה-API כולל גם method getTooltipText()
אפשר להשתמש בו כדי לאחזר את הערך של המאפיין tooltipText.
ב-Android מוצג הערך של המאפיין tooltipText כשמשתמשים מעבירים את העכבר מעל
מעבירים את העכבר מעל התצוגה או לוחצים לחיצה ארוכה על התצוגה.