תיאורי כלים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כדאי לנסות את הדרך של כתיבת אימייל
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), כמו בדוגמה הבאה:
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 כולל גם את השיטה getTooltipText() שבה אפשר להשתמש כדי לאחזר את הערך של המאפיין tooltipText.
ב-Android, הערך של מאפיין tooltipText מוצג כשמשתמשים מעבירים את העכבר מעל התצוגה או לוחצים לחיצה ארוכה על התצוגה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-26 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-26 (שעון UTC)."],[],[],null,["Try the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to add components in Compose. \n[Tooltip →](/develop/ui/compose/components/tooltip) \n\n\u003cbr /\u003e\n\nA tooltip is a small descriptive message that appears near a view when users\nlong press the view or hover their mouse over it. This is useful when your app\nuses an icon to represent an action or piece of information to save space in the\nlayout. This page shows you how to add these tooltips on Android 8.0 (API level\n26) and higher.\n\nSome scenarios, such as those in productivity apps, require a descriptive method\nof communicating ideas and actions. You can use tooltips to display a\ndescriptive message, as shown in figure 1.\n\n**Figure 1.** Tooltip displayed in an Android app.\n\nSome standard widgets display tooltips based on the content of the `title` or\n`content description` properties. Starting in Android 8.0, you can specify the\ntext displayed in the tooltip regardless of the value of other properties.\n\nSetting the tooltip text\n\nYou can specify the tooltip text in a [View](/reference/android/view/View) by calling the\n[setTooltipText()](/reference/android/view/View#setTooltipText(java.lang.CharSequence)) method. You can set\nthe `tooltipText` property using the corresponding XML attribute or API.\n\nTo specify the tooltip text in your XML files, set the [android:tooltipText](/reference/android/R.styleable#View_tooltipText) attribute, as shown\nin the following example: \n\n \u003candroid.support.design.widget.FloatingActionButton\n android:id=\"@+id/fab\"\n android:tooltipText=\"Send an email\" /\u003e\n\nTo specify the tooltip text in your code, use the [setTooltipText(CharSequence)](/reference/android/view/View#setTooltipText(java.lang.CharSequence)) method, as shown in the following example: \n\nKotlin \n\n```kotlin\nval fab: FloatingActionButton = findViewById(R.id.fab)\nfab.tooltipText = \"Send an email\"\n```\n\nJava \n\n```java\nFloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);\nfab.setTooltipText(\"Send an email\");\n```\n\nThe API also includes a [getTooltipText()](/reference/android/view/View#getTooltipText()) method that\nyou can use to retrieve the value of the `tooltipText` property.\n\nAndroid displays the value of the `tooltipText` property when users hover their\nmouse over the view or long press the view."]]
