رفتن به محتوای اصلی
  • معرفی
  • نصب
  • Tailwind
  • وب کامپوننت‌ها (بدون React)
  • دوزبانه، فارسی و انگلیسی
  • پلاگین‌های فیگما
  • استفاده با هوش مصنوعی
  • آیکون‌ها
  • راهنمای آیکون‌ها
  • سفارشی‌سازی و تم
  • حرکت و ریزتعامل‌ها
  • حالت‌های کامپوننت‌ها
  • فونت و تایپوگرافی
  • دسترس‌پذیری
  • نوشتن متن رابط
  • رنگ‌ها
  • برند کاشی
  • مقایسه با دیگران
  • نسخه‌ها
  • سیاست تغییرات
  • مهاجرت به ۲.۰
  • امنیت
  • حجم کامپوننت‌ها
  • فیلد فارسی
  • دیت‌پیکر شمسی
  • کد تأیید (OTP)
  • بازهٔ تاریخ شمسی
  • انتخاب ماه
  • شمارش معکوس
  • هیت‌مپ فعالیت
  • انتخاب استان
  • نقشهٔ ایران
  • فرم نشانی
  • انتخاب نوبت
  • ویرایش نگارشی
  • نمایش مبلغ
  • بازهٔ قیمت
  • کارت بانکی
  • رسید پرداخت
  • برگ تقویم
  • لوگوی بانک‌ها
  • ابزارهای فارسی
  • آپلود فایل
  • آکاردئون
  • آواتار
  • اسپلیتر
  • استپر
  • اسکلتون
  • اسلایدر
  • اعتبارسنجی فرم
  • امتیاز ستاره‌ای
  • انتخاب چندتایی
  • انتخاب رنگ
  • بج
  • بردکرامب
  • برگهٔ پایین
  • بنر
  • پاپ‌اور
  • تایم‌لاین
  • تب‌ها
  • تور معرفی
  • توست
  • تولتیپ
  • جداکننده و کلید میان‌بر
  • جدول داده
  • جستجو با پیشنهاد
  • چک‌باکس
  • چیپس
  • حالت خالی
  • دراپ‌داون
  • دکمه
  • دکمهٔ کپی
  • دیالوگ
  • رادیو
  • سایدبار
  • سگمنت
  • سلکت
  • سوییچ
  • صفحه‌بندی
  • قدرت رمز عبور
  • کارت
  • کارت آمار
  • کاروسل
  • کامبوباکس
  • کامند پالت
  • کشو
  • گروه دکمه
  • گیج
  • منوی راست‌کلیک
  • نمای درختی
  • نمودار
  • نمونهٔ رنگ
  • نوار پیشرفت
  • نوار ناوبری
  • ورودی
  • ورودی تگ
  • ورودی عدد
  • ویرایش درجا
  • هشدار
شروع کنید

بازهٔ قیمت

فیلتر قیمت با دو فیلد «از» و «تا» به تومان و اسلایدر دودستگیره که با هم هماهنگ‌اند.

npm i @kashi-ui/react @kashi-ui/css
import { PriceRange } from "@kashi-ui/react";

CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۶ کیلوبایت + هستهٔ مشترکراهنمای نصب

import { PriceRange } from "@kashi-ui/react";

نمونه

عدد را تایپ کنید یا دستگیره‌ها را بکشید. فیلدها ارقام فارسی و انگلیسی را می‌پذیرند، جداکنندهٔ هزارگان خودکار می‌آید و با خروج از فیلد یا Enter عدد به گام نزدیک گرد و داخل بازه نگه داشته می‌شود؛ «از» هیچ‌وقت از «تا» بیشتر نمی‌شود.

قیمت

۱٬۵۰۰٬۰۰۰ تا ۱۸٬۰۰۰٬۰۰۰ تومان

<PriceRange
label="قیمت"
min={0}
max={25_000_000}
step={100_000}
value={range}
onChange={setRange}
name="price"
/>

با name="price"، دو فیلد price_min و price_max در فرم ارسال می‌شوند.

ویژگی‌ها (props)
نامتوضیح، نوع و پیش‌فرض
min / max

کمترین و بیشترین قیمت ممکن

نوع: number

value / defaultValue

بازهٔ انتخاب‌شده

نوع: [number, number]پیش‌فرض [min, max]

onChange

نوع: (value: [number, number]) => void

step

گام اسلایدر و گرد کردن عدد تایپ‌شده

نوع: numberپیش‌فرض 1000

label

عنوان فیلتر، مثل «قیمت»

نوع: ReactNode

unit

واحد کنار فیلدها

نوع: ReactNodeپیش‌فرض «تومان»

name

دو فیلد name_min و name_max در فرم

نوع: string

labels

متن «از»، «تا»، «ارزان‌ترین» و «گران‌ترین»

نوع: { from?, to?, min?, max? }

دسترس‌پذیری

کل فیلتر یک گروه با نام برچسب است. هر فیلد و هر دستگیره نام جدا دارد («از قیمت»، «تا قیمت») و دستگیره‌ها input type="range" بومی‌اند، پس با فلش‌ها و Home/End کار می‌کنند و صفحه‌خوان مبلغ را به تومان می‌خواند.

راهنمای استفاده

کِی استفاده کنیم

  • فیلتر قیمت در فهرست کالا، آگهی یا ملک.
  • هر بازهٔ عددی پولی که کاربر هم دقیق تایپ می‌کند و هم سریع می‌کشد.

کِی استفاده نکنیم

درست و نادرست

  1. درست
    درست: min و max را از کالاهای همان فهرست بگیرید تا دستگیره‌ها معنا داشته باشند.
    نادرست
    نادرست: بازهٔ صفر تا یک میلیارد برای فهرستی که گران‌ترین کالایش دو میلیون است.
  2. درست
    درست: step متناسب با قیمت‌ها: ۱۰۰ هزار تومان برای لوازم خانگی.
    نادرست
    نادرست: گام ۱ تومانی که کشیدن دستگیره را بی‌فایده می‌کند.

وب کامپوننت

همین کامپوننت بدون React، برای HTML، وردپرس، Vue، Svelte و Angular: <kashi-price-range> در @kashi-ui/elements. value دو عدد با ویرگول است. با name، دو فیلد name_min و name_max در فرم ارسال می‌شوند.

نصب

بدون ابزار ساخت، این دو خط را در <head> صفحه بگذارید:

CDN
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@kashi-ui/css/dist/kashi.css">
<script type="module" src="https://cdn.jsdelivr.net/npm/@kashi-ui/elements/dist/cdn/kashi-elements.js"></script>

یا با npm، و فقط همین بخش را وارد کنید:

npm
npm i @kashi-ui/elements @kashi-ui/css
import "@kashi-ui/css";
import "@kashi-ui/elements/commerce.js";

نمونه

<kashi-price-range label="قیمت" min="0" max="25000000" step="100000" value="1500000,18000000" name="price"></kashi-price-range>

ویژگی‌ها

ویژگی‌های وب کامپوننت
نامتوضیح، نوع و پیش‌فرض
label

عنوان فیلتر

نوع: متن

min / max

بازهٔ قیمت ممکن

نوع: عددپیش‌فرض 0 / 100000000

step

گام اسلایدر و گرد کردن

نوع: عددپیش‌فرض 1000

value

بازهٔ انتخاب‌شده

نوع: دو عددپیش‌فرض min,max

unit

واحد کنار فیلدها

نوع: متنپیش‌فرض تومان

name

دو فیلد name_min و name_max

نوع: متن

disabled

غیرفعال

نوع: بولی

رویدادها و JavaScript

نامتوضیح
kashi-changedetail: { value: [از، تا] }
.value[از، تا]