دکمهها به کاربر اجازه میدهند تا یک عمل تعریفشده را انجام دهد. پنج نوع دکمه وجود دارد:
نوع | ظاهر | هدف |
|---|---|---|
| پر شده | پسزمینهی یکدست با متن متضاد. | برای اقدامات اصلی، مانند «ارسال» و «ذخیره»، جلوه سایه بر اهمیت دکمه تأکید میکند. |
| تُنال | رنگ پس زمینه برای مطابقت با سطح تغییر میکند. | برای اقدامات اولیه یا مهم. دکمههای توپر وزن بصری ایجاد میکنند و برای اقداماتی مانند «افزودن به سبد خرید» و «ورود» مناسب هستند. |
| مرتفع | سایه باعث میشه بیشتر به چشم بیاد. | برای اقدامات اصلی یا مهم. برای برجستهتر کردن دکمه، ارتفاع را افزایش دهید. |
| تشریح شده | دارای حاشیهای بدون پر کردن است. | برای اقداماتی که مهم هستند اما اصلی نیستند. دکمههای outline به خوبی با دکمههای دیگر جفت میشوند تا اقدامات جایگزین و ثانویه مانند «لغو» یا «بازگشت» را نشان دهند. |
| متن | متن بدون پسزمینه یا حاشیه. | برای اقدامات کماهمیتتر مانند لینکهای ناوبری، یا اقدامات ثانویه مانند «بیشتر بدانید» یا «مشاهده جزئیات». |
سازگاری نسخه
این پیادهسازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شده باشد.
وابستگیها
ایجاد یک دکمه پر شده
کامپوننت دکمهی پر شده از ترکیببندی پایهی Button استفاده میکند. این کامپوننت به طور پیشفرض با یک رنگ ثابت پر شده است.
نتایج

یک دکمه با تُن رنگی پر شده ایجاد کنید
کامپوننت دکمه با تُن رنگیِ پر شده از ترکیبپذیر FilledTonalButton استفاده میکند. این کامپوننت به طور پیشفرض با یک رنگ تُن رنگی پر شده است.
نتایج

یک دکمه با طرح کلی ایجاد کنید
کامپوننت دکمه outline از ترکیببندی OutlinedButton استفاده میکند. به طور پیشفرض با یک outline ظاهر میشود.
نتایج

ایجاد دکمه برجسته
کامپوننت دکمهی مرتفع از ترکیببندی ElevatedButton استفاده میکند. این کامپوننت دارای سایهای است که به طور پیشفرض جلوهی ارتفاع را نشان میدهد و به صورت یک دکمهی حاشیهدار با سایه ظاهر میشود.
نتایج

ایجاد دکمه متنی
کامپوننت دکمه متنی از ترکیببندی TextButton استفاده میکند. تا زمانی که کلیک نشود، فقط به صورت متن نمایش داده میشود. به طور پیشفرض، هیچ طرح یا فرم ثابتی ندارد.
نتایج

نکات کلیدی
-
onClick: تابعی که هنگام فشردن دکمه توسط کاربر فراخوانی میشود. -
enabled: وقتی مقدار این پارامتر false باشد، دکمه غیرفعال و در دسترس به نظر نمیرسد. -
colors: نمونهای ازButtonColorsکه رنگهای استفاده شده در دکمه را تعیین میکند. -
contentPadding: فاصلهی بین دکمهها.
مجموعههایی که حاوی این راهنما هستند
این راهنما بخشی از این مجموعههای راهنمای سریعِ برگزیده است که اهداف گستردهتر توسعه اندروید را پوشش میدهد:
