التلميح هو رسالة وصفية صغيرة تظهر بالقرب من طريقة العرض عند المستخدمين الضغط مع الاستمرار على العرض أو تمرير الماوس فوقه. ويفيد ذلك في حال كان تطبيقك تستخدم أيقونة لتمثيل إجراء أو جزء من المعلومات لتوفير مساحة في التصميم. توضّح لك هذه الصفحة كيفية إضافة هذه التلميحات على Android 8.0 (مستوى واجهة برمجة التطبيقات). 26) وأعلى.
تتطلب بعض السيناريوهات، مثل تلك في تطبيقات الإنتاجية، طريقة وصفية إيصال الأفكار والإجراءات. يمكنك استخدام التلميحات لعرض رسالة وصفية، كما هو موضح في الشكل 1.
الشكل 1. تلميح معروض في تطبيق Android
تعرض بعض التطبيقات المصغّرة العادية تلميحات استنادًا إلى محتوى title أو
موقعان (content description) بدءًا من الإصدار Android 8.0، يمكنك تحديد
النص المعروض في التلميح بغض النظر عن قيمة الخصائص الأخرى.
تعيين نص التلميح
يمكنك تحديد نص التلميح في View من خلال استدعاء
طريقة setTooltipText(). يمكنك تحديد
السمة tooltipText باستخدام سمة XML المقابلة أو واجهة برمجة التطبيقات.
لتحديد نص التلميح في ملفات 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");
تتضمّن واجهة برمجة التطبيقات أيضًا طريقة getTooltipText()
التي يمكنك استخدامها لاسترداد قيمة السمة tooltipText.
يعرض Android قيمة السمة tooltipText عندما يمرِّر المستخدمون مؤشر الماوس فوق
ضع مؤشر الماوس فوق العرض أو اضغط مع الاستمرار على العرض.