کشو
پنلی که از کنار صفحه باز میشود؛ برای فیلترها، جزئیات یک ردیف، تنظیمات و منوی گوشی، با انیمیشن ورود و خروج.
npm i @kashi-ui/react @kashi-ui/cssimport { Drawer } from "@kashi-ui/react";CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۰ کیلوبایت + هستهٔ مشترکراهنمای نصب
npx shadcn@latest add @kashi/drawerکد خودِ کامپوننت در پوشهٔ components/kashi پروژهٔ شما کپی میشود. برای نسخههای قدیمی shadcn، راهنمای «دربارهٔ shadcn» را ببینید.دربارهٔ shadcn
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"> ساخته میشود؛ پنجره در وب کامپوننتها را ببینید.
برای انتخاب کوتاه در گوشی، برگهٔ پایین راحتتر است چون با شست در دسترس است.
ویژگیها
| نام | توضیح، نوع و پیشفرض |
|---|---|
open | باز بودن (کنترلشده) |
onOpenChange | هنگام بستن با Esc، پسزمینه یا دکمهٔ بستن |
title | عنوان — الزامی، نام کشو برای صفحهخوان |
description | توضیح زیر عنوان |
side | سمت باز شدن؛ در RTL «start» سمت راست است |
size | پهنا |
footer | دکمههای پایین، همیشه دیده میشوند |
dismissible | بستن با کلیک روی پسزمینه |
closeLabel | متن دکمهٔ بستن برای صفحهخوان |
متغیرهای CSS: --k-drawer-width و --k-dialog-backdrop.
دسترسپذیری
- عنوان با
aria-labelledbyنام کشو است و توضیح باaria-describedbyخوانده میشود. - بقیهٔ صفحه هنگام باز بودن از دسترس صفحهخوان و کیبورد خارج است.
- با «کاهش حرکت» سیستمعامل، کشو بدون انیمیشن باز و بسته میشود.
راهنمای استفاده
کِی استفاده کنیم
- فیلترهای یک فهرست یا جدول، بیآنکه کاربر صفحه را ترک کند.
- جزئیات یک ردیف یا سفارش کنار همان فهرست.
- فرم کوتاه ویرایش یا تنظیمات یک بخش.
کِی استفاده نکنیم
- تأیید یک تصمیم یا پیام کوتاه؛ پنجرهٔ وسط صفحه روشنتر است. دیالوگ
- انتخاب کوتاه در گوشی؛ با شست راحتتر است. برگهٔ پایین
- کار طولانی چندمرحلهای؛ صفحهٔ جدا بسازید.
درست و نادرست
- درست
درست: دکمههای اصلی را در footerبگذارید تا با اسکرول محتوا گم نشوند: «پاک کردن» و «اعمال».نادرستنادرست: دکمهٔ اعمال را ته یک فهرست بلند فیلتر، جایی که کاربر باید تا آخر اسکرول کند. - درست
درست: عنوان کشو بگوید داخلش چیست: «فیلترها»، «سفارش ۱۴۰۵-۲۸۴۱». نادرستنادرست: عنوان کلی مثل «جزئیات» یا «پنل».