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

حجم کامپوننت‌ها

حجم هر کامپوننت کاشی در برنامهٔ شما (minify و gzip) و سقفی که تست خودکار نمی‌گذارد از آن بیشتر شود.

هر عدد همان چیزی است که با import همان یک کامپوننت به برنامهٔ شما اضافه می‌شود: کد minify و tree-shake شده با gzip، شامل کامپوننت‌های وابسته و تابع‌های @kashi-ui/persian که لازم دارد و بدون خود React. این اعداد در هر بیلد دوباره اندازه گرفته می‌شوند.

هستهٔ مشترک

همهٔ کامپوننت‌ها یک هستهٔ مشترک دارند: فرهنگ متن‌های فارسی، ارقام و نام ماه‌های شمسی. این هسته ۵٫۰ کیلوبایت است و در برنامه فقط یک بار بارگذاری می‌شود، هر چند کامپوننت که استفاده کنید. با <KashiProvider locale="en"> فرهنگ انگلیسی هم اضافه می‌شود: ۲٫۹ کیلوبایت بیشتر. ستون «خودِ کامپوننت» حجم اضافه بر این هسته است.

سقف حجم

هر کامپوننت سقفی دارد که حدود ۱۰٪ بالاتر از حجم فعلی است. اگر تغییری کامپوننتی را از سقفش بزرگ‌تر کند، تست شکست می‌خورد و تغییر منتشر نمی‌شود؛ بزرگ شدن عمدی باید با به‌روز کردن سقف، آگاهانه و در همان تغییر ثبت شود.

کامپوننت‌های React

کامپوننتخودِ کامپوننتبا هستهسقف
آکاردئونaccordion۰٫۱ کیلوبایت۰٫۴ کیلوبایت۰٫۵ کیلوبایت
گروه دکمهbutton-group۰٫۱ کیلوبایت۰٫۲ کیلوبایت۰٫۲ کیلوبایت
کارتcard۰٫۱ کیلوبایت۰٫۶ کیلوبایت۰٫۷ کیلوبایت
چک‌باکسcheckbox۰٫۱ کیلوبایت۰٫۸ کیلوبایت۱٫۰ کیلوبایت
چیپسchip-group۰٫۱ کیلوبایت۰٫۷ کیلوبایت۰٫۸ کیلوبایت
دراپ‌داونdropdown-menu۰٫۱ کیلوبایت۱٫۴ کیلوبایت۱٫۷ کیلوبایت
جداکننده و کلید میان‌برmisc۰٫۱ کیلوبایت۰٫۳ کیلوبایت۰٫۴ کیلوبایت
پاپ‌اورpopover۰٫۱ کیلوبایت۰٫۸ کیلوبایت۱٫۰ کیلوبایت
رادیوradio۰٫۱ کیلوبایت۱٫۱ کیلوبایت۱٫۲ کیلوبایت
سگمنتsegmented-control۰٫۱ کیلوبایت۰٫۷ کیلوبایت۰٫۹ کیلوبایت
اسکلتونskeleton۰٫۱ کیلوبایت۰٫۳ کیلوبایت۰٫۴ کیلوبایت
تب‌هاtabs۰٫۱ کیلوبایت۱٫۲ کیلوبایت۱٫۴ کیلوبایت
تولتیپtooltip۰٫۱ کیلوبایت۱٫۲ کیلوبایت۱٫۴ کیلوبایت
نمای درختیtree-view۰٫۱ کیلوبایت۱٫۲ کیلوبایت۱٫۴ کیلوبایت
modal۰٫۱ کیلوبایت۰٫۴ کیلوبایت۰٫۵ کیلوبایت
Fieldfield۰٫۴ کیلوبایت۵٫۴ کیلوبایت۶٫۱ کیلوبایت
بنرbanner۰٫۴ کیلوبایت۵٫۵ کیلوبایت۶٫۱ کیلوبایت
بجbadge۰٫۵ کیلوبایت۵٫۵ کیلوبایت۶٫۱ کیلوبایت
استپرstepper۰٫۵ کیلوبایت۵٫۵ کیلوبایت۶٫۲ کیلوبایت
دکمهbutton۰٫۶ کیلوبایت۵٫۶ کیلوبایت۶٫۲ کیلوبایت
بردکرامبbreadcrumb۰٫۶ کیلوبایت۵٫۶ کیلوبایت۶٫۳ کیلوبایت
کارت آمارstat۰٫۷ کیلوبایت۵٫۷ کیلوبایت۶٫۳ کیلوبایت
نمونهٔ رنگswatch-group۰٫۷ کیلوبایت۵٫۷ کیلوبایت۶٫۳ کیلوبایت
نوار پیشرفتprogress۰٫۷ کیلوبایت۵٫۷ کیلوبایت۶٫۳ کیلوبایت
سایدبارside-nav۰٫۷ کیلوبایت۵٫۷ کیلوبایت۶٫۳ کیلوبایت
شمارش معکوسcountdown۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۳ کیلوبایت
BankBadgebank-badge۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۳ کیلوبایت
آواتارavatar۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۳ کیلوبایت
قدرت رمز عبورpassword-strength۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۴ کیلوبایت
امتیاز ستاره‌ایrating۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۴ کیلوبایت
هشدارalert۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۴ کیلوبایت
اسپلیترsplitter۰٫۸ کیلوبایت۵٫۸ کیلوبایت۶٫۴ کیلوبایت
گیجmeter۰٫۹ کیلوبایت۵٫۹ کیلوبایت۶٫۵ کیلوبایت
حالت خالیempty-state۰٫۹ کیلوبایت۶٫۰ کیلوبایت۶٫۶ کیلوبایت
اسلایدرslider۱٫۰ کیلوبایت۶٫۰ کیلوبایت۶٫۶ کیلوبایت
کشوdrawer۱٫۰ کیلوبایت۶٫۰ کیلوبایت۶٫۶ کیلوبایت
دیالوگdialog۱٫۰ کیلوبایت۶٫۰ کیلوبایت۶٫۴ کیلوبایت
ویرایش درجاinline-edit۱٫۱ کیلوبایت۶٫۱ کیلوبایت۶٫۷ کیلوبایت
دکمهٔ کپیcopy-button۱٫۱ کیلوبایت۶٫۱ کیلوبایت۶٫۷ کیلوبایت
صفحه‌بندیpagination۱٫۲ کیلوبایت۶٫۲ کیلوبایت۶٫۸ کیلوبایت
تور معرفیtour۱٫۲ کیلوبایت۶٫۲ کیلوبایت۶٫۸ کیلوبایت
کد تأیید (OTP)otp-input۱٫۲ کیلوبایت۶٫۲ کیلوبایت۶٫۸ کیلوبایت
منوی راست‌کلیکcontext-menu۱٫۴ کیلوبایت۶٫۴ کیلوبایت۷٫۱ کیلوبایت
RelativeTimerelative-time۱٫۵ کیلوبایت۶٫۵ کیلوبایت۷٫۲ کیلوبایت
ورودی عددnumber-input۱٫۵ کیلوبایت۶٫۵ کیلوبایت۷٫۲ کیلوبایت
برگ تقویمdate-tile۱٫۶ کیلوبایت۶٫۶ کیلوبایت۷٫۳ کیلوبایت
بازهٔ قیمتprice-range۱٫۶ کیلوبایت۶٫۶ کیلوبایت۷٫۳ کیلوبایت
نمایش مبلغmoney۱٫۷ کیلوبایت۶٫۷ کیلوبایت۷٫۴ کیلوبایت
فیلد فارسیplate-input۱٫۷ کیلوبایت۶٫۷ کیلوبایت۷٫۴ کیلوبایت
توستtoast۱٫۸ کیلوبایت۶٫۸ کیلوبایت۷٫۵ کیلوبایت
برگهٔ پایینbottom-sheet۱٫۸ کیلوبایت۶٫۹ کیلوبایت۷٫۶ کیلوبایت
تایم‌لاینtimeline۱٫۸ کیلوبایت۶٫۹ کیلوبایت۷٫۶ کیلوبایت
انتخاب ماهmonth-picker۱٫۸ کیلوبایت۶٫۹ کیلوبایت۷٫۶ کیلوبایت
نوار ناوبریnavbar۱٫۹ کیلوبایت۶٫۹ کیلوبایت۷٫۵ کیلوبایت
ورودی تگtag-input۱٫۹ کیلوبایت۶٫۹ کیلوبایت۷٫۷ کیلوبایت
ورودیinput۲٫۱ کیلوبایت۷٫۱ کیلوبایت۷٫۸ کیلوبایت
جستجو با پیشنهادsearch-suggest۲٫۲ کیلوبایت۷٫۲ کیلوبایت۸٫۰ کیلوبایت
جدول دادهdata-table۲٫۳ کیلوبایت۷٫۳ کیلوبایت۸٫۰ کیلوبایت
کارت بانکیbank-card۲٫۴ کیلوبایت۷٫۴ کیلوبایت۸٫۲ کیلوبایت
هیت‌مپ فعالیتactivity-heatmap۲٫۵ کیلوبایت۷٫۵ کیلوبایت۸٫۳ کیلوبایت
use-form۲٫۵ کیلوبایت۷٫۵ کیلوبایت۸٫۳ کیلوبایت
کامبوباکسcombobox۲٫۵ کیلوبایت۷٫۵ کیلوبایت۸٫۴ کیلوبایت
فیلد فارسیnational-id-input۲٫۶ کیلوبایت۷٫۶ کیلوبایت۸٫۴ کیلوبایت
فیلد فارسیlegal-id-input۲٫۶ کیلوبایت۷٫۶ کیلوبایت۸٫۴ کیلوبایت
فیلد فارسیkeyboard-fix-input۲٫۷ کیلوبایت۷٫۷ کیلوبایت۸٫۵ کیلوبایت
کاروسلcarousel۲٫۸ کیلوبایت۷٫۸ کیلوبایت۸٫۶ کیلوبایت
فیلد فارسیpostal-code-input۲٫۹ کیلوبایت۷٫۹ کیلوبایت۸٫۷ کیلوبایت
فیلد فارسیtime-input۳٫۰ کیلوبایت۸٫۰ کیلوبایت۸٫۸ کیلوبایت
انتخاب رنگcolor-picker۳٫۰ کیلوبایت۸٫۰ کیلوبایت۸٫۸ کیلوبایت
انتخاب استانprovince-select۳٫۱ کیلوبایت۸٫۱ کیلوبایت۸٫۹ کیلوبایت
ویرایش نگارشیpersian-textarea۳٫۲ کیلوبایت۸٫۲ کیلوبایت۹٫۱ کیلوبایت
سلکتselect۳٫۳ کیلوبایت۸٫۳ کیلوبایت۹٫۲ کیلوبایت
فیلد فارسیmobile-input۳٫۳ کیلوبایت۸٫۳ کیلوبایت۹٫۲ کیلوبایت
فیلد فارسیlandline-input۳٫۳ کیلوبایت۸٫۳ کیلوبایت۹٫۲ کیلوبایت
کامند پالتcommand-palette۳٫۴ کیلوبایت۸٫۴ کیلوبایت۹٫۳ کیلوبایت
دیت‌پیکر شمسیcalendar۳٫۴ کیلوبایت۸٫۴ کیلوبایت۹٫۳ کیلوبایت
انتخاب چندتاییmulti-select۳٫۶ کیلوبایت۸٫۶ کیلوبایت۹٫۶ کیلوبایت
انتخاب نوبتappointment-picker۳٫۶ کیلوبایت۸٫۶ کیلوبایت۹٫۶ کیلوبایت
فیلد فارسیprice-input۳٫۸ کیلوبایت۸٫۸ کیلوبایت۹٫۸ کیلوبایت
فیلد فارسیiban-input۴٫۱ کیلوبایت۹٫۱ کیلوبایت۱۰٫۱ کیلوبایت
فیلد فارسیcard-number-input۴٫۳ کیلوبایت۹٫۳ کیلوبایت۱۰٫۴ کیلوبایت
نمودارchart۴٫۹ کیلوبایت۹٫۹ کیلوبایت۱۰٫۹ کیلوبایت
بازهٔ تاریخ شمسیdate-range-picker۴٫۹ کیلوبایت۹٫۹ کیلوبایت۱۰٫۹ کیلوبایت
رسید پرداختpayment-receipt۵٫۶ کیلوبایت۱۰٫۶ کیلوبایت۱۱٫۷ کیلوبایت
آپلود فایلfile-upload۵٫۹ کیلوبایت۱۰٫۹ کیلوبایت۱۲٫۰ کیلوبایت
دیت‌پیکر شمسیdate-picker۶٫۲ کیلوبایت۱۱٫۲ کیلوبایت۱۲٫۴ کیلوبایت
نقشهٔ ایرانiran-map۶٫۳ کیلوبایت۱۱٫۳ کیلوبایت۱۲٫۵ کیلوبایت
CitySelectcity-select۹٫۴ کیلوبایت۱۴٫۵ کیلوبایت۱۵٫۹ کیلوبایت
فیلد فارسیpersian-input۱۰٫۱ کیلوبایت۱۵٫۱ کیلوبایت۱۶٫۷ کیلوبایت
فرم نشانیaddress-form۱۸٫۱ کیلوبایت۲۳٫۱ کیلوبایت۲۵٫۵ کیلوبایت

وب کامپوننت‌ها

هر ماژول چند عنصر هم‌خانواده را با هم دارد و هسته و ابزارهای فارسی داخل خودش است. از CDN، فقط بارگذار کوچک اول دانلود می‌شود و هر ماژول وقتی عنصرش در صفحه بیاید.

ماژولحجمسقف
بارگذار CDN (همهٔ عنصرها، بارگذاری هنگام نیاز)kashi-elements.js۲٫۴ کیلوبایت۲٫۷ کیلوبایت
منو و پاپ‌اور@kashi-ui/elements/menu.js۳٫۰ کیلوبایت۳٫۴ کیلوبایت
اعلان@kashi-ui/elements/toast.js۷٫۰ کیلوبایت۷٫۷ کیلوبایت
کد تأیید@kashi-ui/elements/fields.js۷٫۳ کیلوبایت۸٫۱ کیلوبایت
فیلد متنی و بنر@kashi-ui/elements/basic.js۸٫۴ کیلوبایت۹٫۳ کیلوبایت
گفتگو، زبانه، راهنما و کپی@kashi-ui/elements/overlay.js۹٫۳ کیلوبایت۱۰٫۳ کیلوبایت
مبلغ، تاریخ و شمارش معکوس@kashi-ui/elements/display.js۹٫۹ کیلوبایت۱۰٫۹ کیلوبایت
انتخاب نوبت@kashi-ui/elements/appointment.js۹٫۹ کیلوبایت۱۰٫۹ کیلوبایت
برچسب، عدد، امتیاز و صفحه‌بندی@kashi-ui/elements/controls.js۱۰٫۲ کیلوبایت۱۱٫۲ کیلوبایت
تقویم و انتخاب تاریخ@kashi-ui/elements/calendar.js۱۱٫۸ کیلوبایت۱۳٫۱ کیلوبایت
جدول داده@kashi-ui/elements/table.js۱۲٫۱ کیلوبایت۱۳٫۴ کیلوبایت
فیلدهای فارسی@kashi-ui/elements/inputs.js۱۲٫۳ کیلوبایت۱۳٫۶ کیلوبایت
نمودارها@kashi-ui/elements/charts.js۱۲٫۹ کیلوبایت۱۴٫۲ کیلوبایت
پالت فرمان، کاروسل، درخت و تور@kashi-ui/elements/nav.js۱۴٫۶ کیلوبایت۱۶٫۱ کیلوبایت
استان، شهر و جستجو@kashi-ui/elements/combobox.js۱۶٫۷ کیلوبایت۱۸٫۴ کیلوبایت
بازهٔ تاریخ، ماه، فایل و رنگ@kashi-ui/elements/pickers.js۱۸٫۳ کیلوبایت۲۰٫۲ کیلوبایت
فرم‌های پیشرفته@kashi-ui/elements/forms.js۲۴٫۲ کیلوبایت۲۶٫۷ کیلوبایت
نقشهٔ ایران و فرم نشانی@kashi-ui/elements/map.js۲۹٫۲ کیلوبایت۳۲٫۲ کیلوبایت

آیکون‌ها

هر کامپوننت @kashi-ui/icons/react فقط طرح خودش را دارد؛ عدد زیر شامل کد مشترک ساخت شش سبک هم هست که یک بار بارگذاری می‌شود. <Icon name> چون هر نامی را می‌پذیرد همهٔ آیکون‌ها را می‌آورد و فقط برای نام‌های پویاست.

importحجمسقف
یک آیکونimport { IconSearch }۴٫۶ کیلوبایت۴٫۸ کیلوبایت
سه آیکونimport { IconSearch, IconHome, IconUser }۴٫۸ کیلوبایت۵٫۱ کیلوبایت

CSS

استایل همهٔ کامپوننت‌ها در @kashi-ui/css، بدون فونت: ۴۶٫۹ کیلوبایت. فایل‌های فونت وزیرمتن جدا و فقط برای وزن‌هایی که صفحه لازم دارد دانلود می‌شوند.