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

حالت‌های کامپوننت‌ها

پنج حالتی که هر کامپوننت کاشی باید درست نشان بدهد، با یک ظاهر و یک API یکسان؛ کِی از کدام استفاده کنیم و کدام کامپوننت کدام را دارد.

هر کامپوننتی که داده نشان می‌دهد یا داده می‌گیرد، جز حالت عادی، پنج حالت دیگر هم دارد. در کاشی هر کدام یک ظاهر و یک نام prop در همهٔ کامپوننت‌ها دارد، تا کاربر همه‌جا یک زبان ببیند و شما هر بار از نو تصمیم نگیرید.

حالت معنا prop ظاهر
بارگذاری داده در راه است loading اسپینر کوچک یا ردیف‌های اسکلتی؛ بقیهٔ صفحه کار می‌کند
خالی داده آمد ولی چیزی نیست emptyMessage پیام کوتاه و راهنما، نه فضای سفید
غیرفعال الان قابل‌استفاده نیست disabled کم‌رنگ؛ در فرم ارسال نمی‌شود
خطا مقدار درست نیست error (یا invalid) حاشیهٔ قرمز، پیام زیر فیلد و یک لرزش کوتاه
فقط‌خواندنی دیده می‌شود ولی عوض نمی‌شود readOnly زمینهٔ ملایم، متن کاملاً خوانا؛ در فرم ارسال می‌شود

امتحان کنید

طراحیReact
<Select label="شهر" options={…} readOnly defaultValue="tehran" />
<Select label="شهر" options={[]} loading />
<Select label="شهر" options={[]} emptyMessage="اول استان را انتخاب کنید." />
<Checkbox label="قوانین را خواندم" defaultChecked readOnly />
<SegmentedControl options={…} defaultValue="week" readOnly />

روی سلکت‌ها بزنید: فقط‌خواندنی و غیرفعال باز نمی‌شوند، بارگذاری ردیف‌های اسکلتی نشان می‌دهد و خالی پیامش را. تیک و سوییچ فقط‌خواندنی با کلیک عوض نمی‌شوند ولی کم‌رنگ هم نیستند.

داده و نمودار

فروش امروز

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

فروش هفته

در حال بارگذاری

فروش هفته

هنوز سفارشی ثبت نشده.
<StatCard label="فروش امروز" value="…" loading />
<BarChart title="فروش هفته" data={[]} loading />
<BarChart title="فروش هفته" data={[]} emptyMessage="هنوز سفارشی ثبت نشده." />

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

  • فقط‌خواندنی یا غیرفعال؟ اگر کاربر باید مقدار را ببیند، کپی کند یا بداند چه ثبت شده (کد ملیِ تأییدشده، سفارشِ ارسال‌شده)، فقط‌خواندنی. اگر گزینه فعلاً معنا ندارد و ارسال هم نمی‌شود (شهر پیش از انتخاب استان)، غیرفعال؛ و کنارش بگویید چرا.
  • بارگذاری یا خالی؟ تا پاسخ نیامده، بارگذاری. اگر آمد و چیزی نبود، خالی؛ و پیام خالی بگوید قدم بعد چیست («اول استان را انتخاب کنید»)، نه فقط «چیزی نیست».
  • اسکلت یا اسپینر؟ جایی که شکل محتوا معلوم است (فهرست، کارت، نمودار) اسکلت؛ برای کارهای کوتاه داخل کنترل (جستجو، اعتبارسنجی) اسپینر کوچک.
  • خطا همیشه با متن؛ رنگ قرمز به‌تنهایی برای کاربر کوررنگ یا صفحه‌خوان کافی نیست. متن خطا را از نوشتن متن رابط بگیرید.

دسترس‌پذیری

  • فقط‌خواندنی با aria-readonly اعلام می‌شود و برخلاف غیرفعال در ترتیب تب می‌ماند، پس صفحه‌خوان مقدار را می‌خواند.
  • بارگذاری با aria-busy="true" روی همان بخش؛ متن «در حال بارگذاری» برای صفحه‌خوان هست و اسکلت برای چشم.
  • پیام خالی و خطا متن واقعی‌اند، نه فقط شکل.
  • با «کاهش حرکت» سیستم‌عامل، درخشش اسکلت و چرخش اسپینر متوقف می‌شوند.

کدام کامپوننت کدام حالت را دارد

کامپوننت بارگذاری خالی غیرفعال خطا فقط‌خواندنی
Input و فیلدهای فارسی ✓ — ✓ ✓ ✓
Select ✓ ✓ ✓ ✓ ✓
Combobox ✓ ✓ ✓ ✓ ✓
MultiSelect ✓ ✓ ✓ ✓ ✓
TagInput — — ✓ ✓ ✓
SearchSuggest ✓ ✓ — — —
Checkbox و Switch — — ✓ ✓ ✓
RadioGroup — — ✓ ✓ ✓
SegmentedControl — — ✓ — ✓
ChipGroup و SwatchGroup — — ✓ — ✓
Rating — — ✓ — ✓
NumberInput و OtpInput — — ✓ ✓ ✓
DatePicker و DateRangePicker — — ✓ ✓ ✓
TimeInput — — ✓ ✓ ✓
Slider — — ✓ — ✓
Button ✓ — ✓ — —
DataTable ✓ ✓ — — —
نمودارها ✓ ✓ — — —
StatCard ✓ — — — —

«—» یعنی آن حالت برای این کامپوننت معنا ندارد یا هنوز اضافه نشده؛ فهرست با هر نسخه کامل‌تر می‌شود.

بدون React

همهٔ ظاهرها در CSS کاشی هستند و با صفت‌های HTML کار می‌کنند:

<!-- فقط‌خواندنی -->
<input class="k-input__control" readonly>
<label class="k-check" data-readonly><input type="checkbox" class="k-checkbox" aria-readonly="true" checked> …</label>
<div class="k-segmented" role="radiogroup" data-readonly aria-readonly="true">…</div>

<!-- بارگذاری و خالی داخل فهرست -->
<ul class="k-listbox" aria-busy="true"><li class="k-listbox__loading"></li><li class="k-listbox__loading"></li></ul>
<ul class="k-listbox"><li class="k-listbox__empty">گزینه‌ای برای انتخاب نیست.</li></ul>