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

نمونهٔ رنگ

انتخاب رنگ از میان نمونه‌های رنگی با نام؛ برای فیلتر رنگ در فروشگاه یا انتخاب رنگ کالا.

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

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

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} />
ویژگی‌ها (props)
نامتوضیح، نوع و پیش‌فرض
options

نمونه‌ها؛ color هر مقدار background

نوع: { value, label, color, disabled? }[]

value / defaultValue

مقدارهای انتخاب‌شده

نوع: string[]پیش‌فرض []

onChange

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

single

فقط یک انتخاب (رادیو)

نوع: booleanپیش‌فرض false

label

عنوان گروه (legend)

نوع: ReactNode

size

اندازهٔ نمونه‌ها

نوع: "sm""md""lg"پیش‌فرض "md"

name

ارسال مقدارها در فرم

نوع: string

دسترس‌پذیری

هر نمونه یک چک‌باکس (یا با single رادیو) بومی با برچسب متنی است، پس رنگ تنها راه شناختن آن نیست. انتخاب با تیک و حلقهٔ برند هم نشان داده می‌شود و صفحه‌خوان «انتخاب شده» را می‌خواند. همهٔ نمونه‌ها یک حاشیهٔ نازک دارند تا رنگ‌های روشن مثل سفید روی زمینهٔ روشن گم نشوند.

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

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

  • فیلتر رنگ در فهرست کالا (چندانتخابی).
  • انتخاب رنگ یک کالا در صفحهٔ خرید با single.

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

  • انتخاب رنگ آزاد با کد هگز، مثلاً برای تم. انتخاب رنگ
  • گزینه‌هایی که رنگ نیستند؛ چیپس روشن‌تر است. چیپس

درست و نادرست

  1. درست
    درست: هر نمونه نام متنی دارد: «طوسی»، «نقره‌ای».
    نادرست
    نادرست: فقط مربع‌های رنگی بی‌نام؛ کسی که رنگ را درست تشخیص نمی‌دهد گیج می‌شود.
  2. درست
    درست: برای رنگ‌هایی که چند طیف دارند (مثل «آبی» در فیلتر) گرادیان چند طیف بدهید.
    نادرست
    نادرست: یک آبی خاص که کاربر فکر کند فقط همان طیف پیدا می‌شود.

متن

  • نام رنگ‌ها را همان‌طور بنویسید که مشتری می‌گوید: «سرمه‌ای»، نه «آبی نیلی تیره».

قاعده‌های کلی لحن، برچسب دکمه و پیام خطا: نوشتن متن رابط

وب کامپوننت

همین کامپوننت بدون React، برای HTML، وردپرس، Vue، Svelte و Angular: <kashi-swatch-group> در @kashi-ui/elements. هر <option> یک نمونه است؛ data-color هر مقدار CSS برای background (رنگ یا گرادیان).

نصب

بدون ابزار ساخت، این دو خط را در <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-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

اندازهٔ نمونه‌ها

نوع: smmdlgپیش‌فرض md

name

ارسال در فرم

نوع: متن

رویدادها و JavaScript

نامتوضیح
kashi-changedetail: { value: [...] }
.valueآرایهٔ مقدارهای انتخاب‌شده