التلميحات

تجربة طريقة Compose

‫Jetpack Compose هي مجموعة أدوات واجهة المستخدِم المقترَحة لنظام Android. تعرَّف على كيفية إضافة مكوّنات في Compose.

تلميح →

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

val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

تتضمّن واجهة برمجة التطبيقات أيضًا طريقة getTooltipText() التي يمكنك استخدامها لاسترداد قيمة السمة tooltipText.

يعرض Android قيمة السمة tooltipText عندما يمرّر المستخدمون مؤشر الماوس فوق طريقة العرض أو يضغطون عليها مع الاستمرار.