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