یک tooltip یک پیام توصیفی کوچک است که وقتی کاربران روی یک view فشار طولانی میدهند یا ماوس خود را روی آن نگه میدارند، در نزدیکی آن ظاهر میشود. این زمانی مفید است که برنامه شما از یک آیکون برای نمایش یک عمل یا بخشی از اطلاعات برای صرفهجویی در فضا در طرحبندی استفاده میکند. این صفحه نحوه اضافه کردن این tooltipها را در اندروید ۸.۰ (سطح API ۲۶) و بالاتر به شما نشان میدهد.
برخی سناریوها، مانند سناریوهای موجود در برنامههای بهرهوری، به روشی توصیفی برای انتقال ایدهها و اقدامات نیاز دارند. میتوانید از راهنماهای ابزار برای نمایش یک پیام توصیفی، همانطور که در شکل ۱ نشان داده شده است، استفاده کنید.
شکل ۱. راهنمای ابزار نمایش داده شده در یک برنامه اندروید
برخی از ویجتهای استاندارد، راهنماهای ابزار را بر اساس محتوای ویژگیهای title یا content description نمایش میدهند. با شروع از اندروید ۸.۰، میتوانید متن نمایش داده شده در راهنما را صرف نظر از مقدار سایر ویژگیها مشخص کنید.
تنظیم متن راهنمای ابزار
شما میتوانید متن tooltip را در یک View با فراخوانی متد setTooltipText() مشخص کنید. میتوانید ویژگی tooltipText را با استفاده از ویژگی XML یا API مربوطه تنظیم کنید.
برای مشخص کردن متن tooltip در فایلهای XML خود، ویژگی android:tooltipText را همانطور که در مثال زیر نشان داده شده است، تنظیم کنید:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
برای مشخص کردن متن tooltip در کد خود، از متد 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");
این API همچنین شامل یک متد getTooltipText() است که میتوانید از آن برای بازیابی مقدار ویژگی tooltipText استفاده کنید.
اندروید مقدار ویژگی tooltipText را زمانی که کاربران ماوس خود را روی نما قرار میدهند یا آن را برای مدت طولانی فشار میدهند، نمایش میدهد.