مولفه Switch به کاربران امکان می دهد بین دو حالت جابجا شوند: علامت زده و علامت زده نشده. از یک سوئیچ استفاده کنید تا کاربر یکی از موارد زیر را انجام دهد:
- یک تنظیم را روشن یا خاموش کنید.
- یک ویژگی را فعال یا غیرفعال کنید.
- یک گزینه را انتخاب کنید.
کامپوننت دارای دو بخش است: شست و مسیر. انگشت شست قسمت قابل کشیدن سوئیچ است و آهنگ پس زمینه است. کاربر می تواند انگشت شست را به سمت چپ یا راست بکشد تا وضعیت سوئیچ را تغییر دهد. آنها همچنین می توانند برای بررسی و پاک کردن سوئیچ ضربه بزنند.
سازگاری نسخه
این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شود.
وابستگی ها
یک سوئیچ را اجرا کنید
مثال زیر یک اجرای حداقلی از Switch composable است:
نتایج
یک انگشت شست سفارشی ایجاد کنید
شما می توانید هر composable را برای پارامتر thumbContent برای ایجاد یک شست سفارشی ارسال کنید. در زیر نمونه ای از سوئیچ است که از یک نماد سفارشی برای انگشت شست خود استفاده می کند:
نتایج
ظاهر بدون علامت مانند مثال در بخش قبل است. با این حال، هنگامی که بررسی می شود، این پیاده سازی به صورت زیر ظاهر می شود:
از رنگ های سفارشی استفاده کنید
از پارامتر colors برای تغییر رنگ انگشت شست و مسیر سوئیچ، با در نظر گرفتن اینکه آیا سوئیچ بررسی شده است، استفاده کنید.
نتایج
نکات کلیدی
پارامترهای اساسی:
-
checked: وضعیت اولیه سوئیچ. -
onCheckedChange: یک تماس برگشتی که زمانی فراخوانی می شود که وضعیت سوئیچ تغییر کند. -
enabled: اینکه سوئیچ فعال یا غیرفعال باشد. -
colors: رنگ هایی که برای سوئیچ استفاده می شود.
-
پارامترهای پیشرفته
-
thumbContent: از این برای سفارشی کردن ظاهر انگشت شست هنگام علامت زدن استفاده کنید. -
colors: از این برای سفارشی کردن رنگ مسیر و انگشت شست استفاده کنید.
-
مجموعه هایی که حاوی این راهنما هستند
این راهنما بخشی از مجموعه‌های راهنمای Quick Guide است که اهداف توسعه Android گسترده‌تری را پوشش می‌دهد:
نمایش اجزای تعاملی
