نکته‌ابزارها

امتحان کردن روش Compose
Jetpack Compose جعبه‌ابزار واسط کاربر توصیه‌شده برای Android است. با نحوه افزودن مؤلفه‌ها در Compose آشنا شوید.

نکته‌ابزار پیام توصیفی کوچکی است که وقتی کاربران روی نمایشی فشار طولانی می‌دهند یا موشواره را روی آن نگه می‌دارند، در نزدیکی آن نمایش ظاهر می‌شود. این ویژگی زمانی مفید است که برنامه‌تان از نمادی برای نشان دادن کنش یا اطلاعاتی برای صرفه‌جویی در فضای چیدمان استفاده می‌کند. این صفحه به شما نشان می‌دهد که چگونه این نکته‌ابزارها را در Android 8.0 (سطح میانای برنامه‌سازی کاربردی 26) و بالاتر اضافه کنید.

برخی‌از سناریوها، مانند سناریوهای موجود در برنامه‌های بهره‌وری، به روشی توصیفی برای انتقال ایده‌ها و کنش‌ها نیاز دارند. می‌توانید از نکته‌ابزارها برای نمایش پیام توصیفی استفاده کنید، همان‌طور که در شکل ۱ نشان داده شده است.

نماگرفت نکته‌ابزار

شکل ۱. نکته‌ابزار نمایش‌داده‌شده در برنامه Android.

برخی‌از ابزاره‌های استاندارد نکته‌ابزارها را براساس محتوای ویژگی‌های title یا content description نمایش می‌دهند. از Android 8.0 به بعد، می‌توانید نوشتار نمایش‌داده‌شده در نکته‌ابزار را صرف‌نظر از مقدار سایر ویژگی‌ها مشخص کنید.

تنظیم نوشتار نکته‌ابزار

می‌توانید نوشتار نکته‌ابزار را در View با فراخوانی روش setTooltipText() مشخص کنید. می‌توانید ویژگی tooltipText را بااستفاده از مشخصه XML یا API مربوطه تنظیم کنید.

برای مشخص کردن نوشتار نکته‌ابزار در فایل‌های 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 را نمایش می‌دهد.