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