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