תיאורי כלים

אפשר לנסות את הדרך של כתיבת הודעה

‫Jetpack Compose היא ערכת הכלים המומלצת לבניית ממשק משתמש ב-Android. איך מוסיפים רכיבים ב-Compose

הסבר קצר →

הסבר קצר הוא הודעה תיאורית קצרה שמופיעה ליד תצוגה כשמשתמשים לוחצים לחיצה ארוכה על התצוגה או מעבירים את העכבר מעליה. האפשרות הזו שימושית כשהאפליקציה משתמשת בסמל כדי לייצג פעולה או מידע מסוים, כדי לחסוך במקום בפריסה. בדף הזה מוסבר איך להוסיף את תיאורי הכלים האלה ב-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), כמו בדוגמה הבאה:

val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

ה-API כולל גם את ה-method getTooltipText() שבעזרתו אפשר לאחזר את הערך של המאפיין tooltipText.

ב-Android, הערך של מאפיין tooltipText מוצג כשמשתמשים מעבירים את העכבר מעל התצוגה או לוחצים לחיצה ארוכה על התצוגה.