یک نوار لغزنده برای محدوده ای از مقادیر ایجاد کنید

Slider composable به کاربران این امکان را می دهد که از طیف وسیعی از مقادیر انتخاب کنند. ممکن است از یک نوار لغزنده استفاده کنید تا به کاربر اجازه دهید کارهای زیر را انجام دهد:

  • تنظیماتی را تنظیم کنید که از طیف وسیعی از مقادیر مانند حجم صدا و روشنایی استفاده می کنند.
  • مانند هنگام تنظیم محدوده قیمت، داده ها را در یک نمودار فیلتر کنید.
  • ورودی کاربر، مانند تعیین رتبه در یک بررسی.

نوار لغزنده حاوی یک آهنگ، انگشت شست، برچسب مقدار و علامت های تیک است:

  • Track : مسیر نوار افقی است که نشان دهنده محدوده مقادیری است که لغزنده می تواند بگیرد.
  • Thumb : انگشت شست یک عنصر کنترلی قابل کشیدن روی نوار لغزنده است که به کاربر اجازه می دهد مقدار خاصی را در محدوده تعریف شده توسط مسیر انتخاب کند.
  • علامت‌های تیک : علامت‌های تیک نشانگرها یا نشانگرهای تصویری اختیاری هستند که در امتداد مسیر نوار لغزنده ظاهر می‌شوند.

این موضوع پیاده سازی های اسلایدر زیر را نشان می دهد:

سازگاری نسخه

این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شود.

وابستگی ها

یک نوار لغزنده اولیه ایجاد کنید

مثال زیر یک نوار لغزنده ساده است. که به کاربر امکان می دهد مقداری از 0.0 تا 1.0 را انتخاب کند. از آنجا که کاربر می تواند هر مقداری را در آن محدوده انتخاب کند، لغزنده پیوسته است.

نتایج

یک جزء لغزنده با مقدار تقریباً سه چهارم در طول مسیر انتخاب شده است.
شکل 1. اجرای اساسی یک نوار لغزنده.

یک اسلایدر پیشرفته ایجاد کنید

قطعه زیر یک نوار لغزنده را پیاده سازی می کند که دارای سه مرحله با محدوده 0.0 تا 50.0 است. از آنجا که انگشت شست به هر مرحله می‌چسبد، این لغزنده گسسته است.

نتایج

متن جایگزین خود را اینجا بنویسید
شکل 2. یک نوار لغزنده با مراحل و محدوده مقدار تنظیم شده.

لغزنده برد

همچنین می توانید از RangeSlider اختصاصی composable استفاده کنید. این به کاربر اجازه می دهد تا دو مقدار را انتخاب کند. این می تواند در مواردی مانند زمانی که کاربر می خواهد حداقل و حداکثر قیمت را انتخاب کند، مفید باشد.

مثال زیر یک مثال نسبتاً ساده از لغزنده دامنه پیوسته است:

نتایج

یک جزء لغزنده محدوده با دو مقدار انتخاب شده است. یک برچسب کران های بالا و پایین انتخاب را نشان می دهد.
شکل 3. اجرای یک نوار لغزنده محدوده.

نکات کلیدی

برای تعریف کامل API به مرجع Slider مراجعه کنید. برخی از پارامترهای کلیدی برای Slider composable به شرح زیر است:

  • value : مقدار فعلی اسلایدر.
  • onValueChange : یک لامبدا که هر بار که مقدار تغییر می کند، فراخوانی می شود.
  • enabled : یک مقدار بولی که نشان می دهد کاربر می تواند با لغزنده تعامل داشته باشد یا خیر.

هنگام اجرای یک نوار لغزنده پیچیده تر، می توانید از پارامترهای زیر نیز استفاده کنید.

  • colors : نمونه‌ای از SliderColors که به شما امکان می‌دهد رنگ‌های لغزنده را کنترل کنید.
  • valueRange : محدوده مقادیری که اسلایدر می تواند بگیرد.
  • steps : تعداد بریدگی‌های روی نوار لغزنده‌ای که انگشت شست به آن می‌چسبد.

همچنین می‌توانید برای شخصی‌سازی کامل‌تر ظاهر مؤلفه، یک thumb و track قابل تنظیم را به Slider ارسال کنید.

مجموعه هایی که حاوی این راهنما هستند

این راهنما بخشی از مجموعه‌های راهنمای Quick Guide است که اهداف توسعه Android گسترده‌تری را پوشش می‌دهد:

بیاموزید که چگونه توابع ترکیب‌پذیر می‌توانند به شما کمک کنند تا به راحتی اجزای رابط کاربری زیبا را بر اساس سیستم طراحی مواد طراحی کنید.

سوال یا بازخورد داشته باشید

به صفحه سوالات متداول ما بروید و درباره راهنماهای سریع بیاموزید یا با ما تماس بگیرید و نظرات خود را با ما در میان بگذارید.