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

کشو

پنلی که از کنار صفحه باز می‌شود؛ برای فیلترها، جزئیات یک ردیف، تنظیمات و منوی گوشی، با انیمیشن ورود و خروج.

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

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

import { Drawer } from "@kashi-ui/react";

نمونه

فیلترها

نتایج را محدود کنید.

وضعیت پرداخت
const [open, setOpen] = useState(false);

<Button onClick={() => setOpen(true)}>فیلترها</Button>
<Drawer
open={open}
onOpenChange={setOpen}
title="فیلترها"
description="نتایج را محدود کنید."
footer={<>
  <Button variant="secondary" onClick={() => setOpen(false)}>پاک کردن</Button>
  <Button variant="primary">اعمال</Button>
</>}
>
<RadioGroup label="وضعیت پرداخت">…</RadioGroup>
</Drawer>

کشو روی <dialog> بومی ساخته شده: فوکوس داخل آن می‌ماند، Esc و کلیک روی پس‌زمینه می‌بندند، اسکرول صفحه قفل می‌شود و بعد از بستن، فوکوس به دکمه‌ای که آن را باز کرده برمی‌گردد. هنگام بستن هم به همان سمتی که آمده برمی‌گردد، نه این‌که ناگهان ناپدید شود.

سمت و اندازه

  • side="end" (پیش‌فرض) در صفحهٔ فارسی از چپ باز می‌شود و side="start" از راست؛ در صفحهٔ انگلیسی برعکس.
  • size: sm (۲۰rem) برای منو، md (۲۶rem) برای فیلتر و فرم کوتاه، lg (۳۶rem) برای جزئیات، full برای تمام صفحه. در گوشی کشو هیچ‌وقت از عرض صفحه بزرگ‌تر نمی‌شود.
  • سربرگ و footer ثابت می‌مانند و فقط محتوای وسط اسکرول می‌خورد.

بدون React، همین کشو با <kashi-dialog placement="end"> ساخته می‌شود؛ پنجره در وب کامپوننت‌ها را ببینید.

برای انتخاب کوتاه در گوشی، برگهٔ پایین راحت‌تر است چون با شست در دسترس است.

ویژگی‌ها

ویژگی‌ها (props)
نامتوضیح، نوع و پیش‌فرض
open

باز بودن (کنترل‌شده)

نوع: boolean

onOpenChange

هنگام بستن با Esc، پس‌زمینه یا دکمهٔ بستن

نوع: (open: boolean) => void

title

عنوان — الزامی، نام کشو برای صفحه‌خوان

نوع: ReactNode

description

توضیح زیر عنوان

نوع: ReactNode

side

سمت باز شدن؛ در RTL «start» سمت راست است

نوع: "start""end"پیش‌فرض "end"

size

پهنا

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

footer

دکمه‌های پایین، همیشه دیده می‌شوند

نوع: ReactNode

dismissible

بستن با کلیک روی پس‌زمینه

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

closeLabel

متن دکمهٔ بستن برای صفحه‌خوان

نوع: stringپیش‌فرض "بستن"

متغیرهای CSS: --k-drawer-width و --k-dialog-backdrop.

دسترس‌پذیری

  • عنوان با aria-labelledby نام کشو است و توضیح با aria-describedby خوانده می‌شود.
  • بقیهٔ صفحه هنگام باز بودن از دسترس صفحه‌خوان و کیبورد خارج است.
  • با «کاهش حرکت» سیستم‌عامل، کشو بدون انیمیشن باز و بسته می‌شود.

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

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

  • فیلترهای یک فهرست یا جدول، بی‌آن‌که کاربر صفحه را ترک کند.
  • جزئیات یک ردیف یا سفارش کنار همان فهرست.
  • فرم کوتاه ویرایش یا تنظیمات یک بخش.

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

  • تأیید یک تصمیم یا پیام کوتاه؛ پنجرهٔ وسط صفحه روشن‌تر است. دیالوگ
  • انتخاب کوتاه در گوشی؛ با شست راحت‌تر است. برگهٔ پایین
  • کار طولانی چندمرحله‌ای؛ صفحهٔ جدا بسازید.

درست و نادرست

  1. درست
    درست: دکمه‌های اصلی را در footer بگذارید تا با اسکرول محتوا گم نشوند: «پاک کردن» و «اعمال».
    نادرست
    نادرست: دکمهٔ اعمال را ته یک فهرست بلند فیلتر، جایی که کاربر باید تا آخر اسکرول کند.
  2. درست
    درست: عنوان کشو بگوید داخلش چیست: «فیلترها»، «سفارش ۱۴۰۵-۲۸۴۱».
    نادرست
    نادرست: عنوان کلی مثل «جزئیات» یا «پنل».