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