برگهٔ پایین
پنلی که از پایین صفحهٔ گوشی بالا میآید؛ با دستگیره کشیده میشود، روی ارتفاعهای تعیینشده میایستد و با کشیدن به پایین بسته میشود.
npm i @kashi-ui/react @kashi-ui/cssimport { BottomSheet } from "@kashi-ui/react";CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۸ کیلوبایت + هستهٔ مشترکراهنمای نصب
npx shadcn@latest add @kashi/bottom-sheetکد خودِ کامپوننت در پوشهٔ components/kashi پروژهٔ شما کپی میشود. برای نسخههای قدیمی shadcn، راهنمای «دربارهٔ shadcn» را ببینید.دربارهٔ shadcn
import { BottomSheet } from "@kashi-ui/react";
نمونه
<BottomSheet open={open} onOpenChange={setOpen} title="مرتبسازی">
<RadioGroup label="ترتیب نمایش">…</RadioGroup>
</BottomSheet>
// دو ارتفاع: نیمه و تقریباً تمام صفحه
<BottomSheet
open={open}
onOpenChange={setOpen}
title="نظر خریداران"
snapPoints={[0.45, 0.9]}
footer={<Button variant="primary">نوشتن نظر</Button>}
>
…
</BottomSheet>روی دسکتاپ هم کار میکند؛ دستگیره را با ماوس بکشید. در گوشی بازش کنید تا حس واقعیاش را ببینید.
ارتفاع و کشیدن
- بدون
snapPointsبرگه به اندازهٔ محتواست (حداکثر ۹۰٪ صفحه) و کشیدن به پایین آن را میبندد. - با
snapPointsمثل[0.45, 0.9]برگه روی این ارتفاعها (به نسبت ارتفاع صفحه) میایستد. بعد از رها کردن، به نزدیکترین ارتفاع میرود؛ پرتاب سریع به بالا یا پایین ارتفاع بعدی را انتخاب میکند و پرتاب به پایین از کوچکترین ارتفاع، برگه را میبندد. - ارتفاع فعلی را با
snapوonSnapChangeکنترل کنید، یا فقطdefaultSnapبدهید. - دستگیره با کیبورد هم کار میکند: Enter بین ارتفاعها جابهجا میکند و کلیدهای جهت بالا و پایین ارتفاع را عوض میکنند.
- محتوای وسط جداگانه اسکرول میخورد و اسکرولش به صفحهٔ پشت منتقل نمیشود.
footerبالای نوار پایین آیفون (safe area) میماند.
ویژگیها
| نام | توضیح، نوع و پیشفرض |
|---|---|
open | باز بودن (کنترلشده) |
onOpenChange | هنگام بستن با کشیدن، Esc یا پسزمینه |
title | عنوان — الزامی، نام برگه برای صفحهخوان |
hideTitle | پنهان کردن عنوان از دید؛ صفحهخوان همچنان میخواند |
description | توضیح زیر عنوان |
snapPoints | ارتفاعهای ایست به نسبت صفحه، از کوچک به بزرگ |
defaultSnap / snap / onSnapChange | اندیس ارتفاع فعلی |
footer | دکمههای پایین |
dismissible | بستن با کشیدن به پایین و کلیک روی پسزمینه |
showClose | دکمهٔ بستن در سربرگ |
متغیرهای CSS: --k-sheet-height، --k-sheet-radius و --k-dialog-width (بیشترین پهنا روی صفحهٔ بزرگ).
دسترسپذیری
- همان رفتار دیالوگ: تلهٔ فوکوس، Esc و برگشت فوکوس پس از بستن.
- کشیدن تنها راه نیست: Esc، کلیک روی پسزمینه و (با
showClose) دکمهٔ بستن هم میبندند و دستگیره با کیبورد ارتفاع را عوض میکند. - دستگیرهٔ دارای ارتفاع،
aria-expandedدارد و نامش «باز کردن کامل برگه» یا «کوچک کردن برگه» است.
راهنمای استفاده
کِی استفاده کنیم
- انتخاب کوتاه در گوشی: مرتبسازی، اشتراکگذاری، انتخاب روش ارسال.
- محتوایی که کاربر کنار صفحه نگاه میکند، مثل نظرها یا مسیر روی نقشه، با چند ارتفاع.
درست و نادرست
- درست
درست: برای فهرست بلند snapPointsبدهید تا برگه نیمه باز شود و کاربر خودش بالا بکشد.نادرستنادرست: برگهای که از اول تمام صفحه را میگیرد و صفحهٔ پشت دیده نمیشود؛ کاربر جایش را گم میکند. - درست
درست: در انتخاب تکگزینهای، با انتخاب کاربر برگه را ببندید. نادرستنادرست: یک دکمهٔ «تأیید» اضافه بعد از انتخاب یک گزینهٔ ساده.