نمونهٔ رنگ
انتخاب رنگ از میان نمونههای رنگی با نام؛ برای فیلتر رنگ در فروشگاه یا انتخاب رنگ کالا.
npm i @kashi-ui/react @kashi-ui/cssimport { SwatchGroup } from "@kashi-ui/react";CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۰٫۷ کیلوبایت + هستهٔ مشترکراهنمای نصب
npx shadcn@latest add @kashi/swatch-groupکد خودِ کامپوننت در پوشهٔ components/kashi پروژهٔ شما کپی میشود. برای نسخههای قدیمی shadcn، راهنمای «دربارهٔ shadcn» را ببینید.دربارهٔ shadcn
npm i @kashi-ui/elements @kashi-ui/cssimport "@kashi-ui/elements/commerce.js";<kashi-swatch-group></kashi-swatch-group>بدون React، برای HTML، وردپرس، Vue و Angular.CDN، نمونه و ویژگیها
import { SwatchGroup } from "@kashi-ui/react";
فیلتر رنگ (چندانتخابی)
آبی ، مشکی
<SwatchGroup
label="رنگ"
value={colors}
onChange={setColors}
options={[
{ value: "blue", label: "آبی", color: "#3b6fd4" },
{ value: "white", label: "سفید", color: "#ffffff" },
{ value: "silver", label: "نقرهای", color: "radial-gradient(#fff, #a9adb3)" },
]}
/>color هر مقدار CSS برای background است: یک رنگ، گرادیان (مثل چند طیف یک رنگ) یا حتی تصویر بافت پارچه با url().
رنگ کالا (یک انتخاب)
<SwatchGroup single size="sm" label="رنگ کالا" options={colors} value={v} onChange={setV} />| نام | توضیح، نوع و پیشفرض |
|---|---|
options | نمونهها؛ color هر مقدار background |
value / defaultValue | مقدارهای انتخابشده |
onChange | |
single | فقط یک انتخاب (رادیو) |
label | عنوان گروه (legend) |
size | اندازهٔ نمونهها |
name | ارسال مقدارها در فرم |
دسترسپذیری
هر نمونه یک چکباکس (یا با single رادیو) بومی با برچسب متنی است، پس رنگ تنها راه شناختن آن نیست. انتخاب با تیک و حلقهٔ برند هم نشان داده میشود و صفحهخوان «انتخاب شده» را میخواند. همهٔ نمونهها یک حاشیهٔ نازک دارند تا رنگهای روشن مثل سفید روی زمینهٔ روشن گم نشوند.
راهنمای استفاده
کِی استفاده کنیم
- فیلتر رنگ در فهرست کالا (چندانتخابی).
- انتخاب رنگ یک کالا در صفحهٔ خرید با
single.
کِی استفاده نکنیم
- انتخاب رنگ آزاد با کد هگز، مثلاً برای تم. انتخاب رنگ
- گزینههایی که رنگ نیستند؛ چیپس روشنتر است. چیپس
درست و نادرست
- درست
درست: هر نمونه نام متنی دارد: «طوسی»، «نقرهای». نادرستنادرست: فقط مربعهای رنگی بینام؛ کسی که رنگ را درست تشخیص نمیدهد گیج میشود. - درست
درست: برای رنگهایی که چند طیف دارند (مثل «آبی» در فیلتر) گرادیان چند طیف بدهید. نادرستنادرست: یک آبی خاص که کاربر فکر کند فقط همان طیف پیدا میشود.
متن
- نام رنگها را همانطور بنویسید که مشتری میگوید: «سرمهای»، نه «آبی نیلی تیره».
قاعدههای کلی لحن، برچسب دکمه و پیام خطا: نوشتن متن رابط
وب کامپوننت
همین کامپوننت بدون React، برای HTML، وردپرس، Vue، Svelte و Angular: <kashi-swatch-group> در @kashi-ui/elements. هر <option> یک نمونه است؛ data-color هر مقدار CSS برای background (رنگ یا گرادیان).
نصب
بدون ابزار ساخت، این دو خط را در <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-swatch-group label="رنگ" name="color" value="blue">
<option value="blue" data-color="#3b6fd4">آبی</option>
<option value="white" data-color="#ffffff">سفید</option>
<option value="black" data-color="#111111">مشکی</option>
<option value="silver" data-color="radial-gradient(circle at 35% 30%, #fff, #a9adb3)">نقرهای</option>
</kashi-swatch-group>ویژگیها
| نام | توضیح، نوع و پیشفرض |
|---|---|
label | عنوان گروه |
value | مقدارهای انتخابشده |
single | فقط یک انتخاب |
size | اندازهٔ نمونهها |
name | ارسال در فرم |
رویدادها و JavaScript
| نام | توضیح |
|---|---|
kashi-change | detail: { value: [...] } |
.value | آرایهٔ مقدارهای انتخابشده |