بازهٔ قیمت
فیلتر قیمت با دو فیلد «از» و «تا» به تومان و اسلایدر دودستگیره که با هم هماهنگاند.
npm i @kashi-ui/react @kashi-ui/cssimport { PriceRange } from "@kashi-ui/react";CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۶ کیلوبایت + هستهٔ مشترکراهنمای نصب
npx shadcn@latest add @kashi/price-rangeکد خودِ کامپوننت در پوشهٔ components/kashi پروژهٔ شما کپی میشود. برای نسخههای قدیمی shadcn، راهنمای «دربارهٔ shadcn» را ببینید.دربارهٔ shadcn
npm i @kashi-ui/elements @kashi-ui/cssimport "@kashi-ui/elements/commerce.js";<kashi-price-range></kashi-price-range>بدون React، برای HTML، وردپرس، Vue و Angular.CDN، نمونه و ویژگیها
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 در فرم ارسال میشوند.
| نام | توضیح، نوع و پیشفرض |
|---|---|
min / max | کمترین و بیشترین قیمت ممکن |
value / defaultValue | بازهٔ انتخابشده |
onChange | |
step | گام اسلایدر و گرد کردن عدد تایپشده |
label | عنوان فیلتر، مثل «قیمت» |
unit | واحد کنار فیلدها |
name | دو فیلد name_min و name_max در فرم |
labels | متن «از»، «تا»، «ارزانترین» و «گرانترین» |
دسترسپذیری
کل فیلتر یک گروه با نام برچسب است. هر فیلد و هر دستگیره نام جدا دارد («از قیمت»، «تا قیمت») و دستگیرهها input type="range" بومیاند، پس با فلشها و Home/End کار میکنند و صفحهخوان مبلغ را به تومان میخواند.
راهنمای استفاده
کِی استفاده کنیم
- فیلتر قیمت در فهرست کالا، آگهی یا ملک.
- هر بازهٔ عددی پولی که کاربر هم دقیق تایپ میکند و هم سریع میکشد.
کِی استفاده نکنیم
- گرفتن یک مبلغ مشخص، مثل مبلغ انتقال. فیلدهای فارسی (kind="price")
- بازهٔ عددی غیرپولی، مثل سن یا متراژ. اسلایدر
درست و نادرست
- درست
درست: minوmaxرا از کالاهای همان فهرست بگیرید تا دستگیرهها معنا داشته باشند.نادرستنادرست: بازهٔ صفر تا یک میلیارد برای فهرستی که گرانترین کالایش دو میلیون است. - درست
درست: stepمتناسب با قیمتها: ۱۰۰ هزار تومان برای لوازم خانگی.نادرستنادرست: گام ۱ تومانی که کشیدن دستگیره را بیفایده میکند.
وب کامپوننت
همین کامپوننت بدون React، برای HTML، وردپرس، Vue، Svelte و Angular: <kashi-price-range> در @kashi-ui/elements. value دو عدد با ویرگول است. با name، دو فیلد name_min و name_max در فرم ارسال میشوند.
نصب
بدون ابزار ساخت، این دو خط را در <head> صفحه بگذارید:
<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 i @kashi-ui/elements @kashi-ui/cssimport "@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 | بازهٔ قیمت ممکن |
step | گام اسلایدر و گرد کردن |
value | بازهٔ انتخابشده |
unit | واحد کنار فیلدها |
name | دو فیلد name_min و name_max |
disabled | غیرفعال |
رویدادها و JavaScript
| نام | توضیح |
|---|---|
kashi-change | detail: { value: [از، تا] } |
.value | [از، تا] |