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

برگهٔ پایین

پنلی که از پایین صفحهٔ گوشی بالا می‌آید؛ با دستگیره کشیده می‌شود، روی ارتفاع‌های تعیین‌شده می‌ایستد و با کشیدن به پایین بسته می‌شود.

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

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

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) می‌ماند.

ویژگی‌ها

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

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

نوع: boolean

onOpenChange

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

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

title

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

نوع: ReactNode

hideTitle

پنهان کردن عنوان از دید؛ صفحه‌خوان همچنان می‌خواند

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

description

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

نوع: ReactNode

snapPoints

ارتفاع‌های ایست به نسبت صفحه، از کوچک به بزرگ

نوع: number[]

defaultSnap / snap / onSnapChange

اندیس ارتفاع فعلی

نوع: numberپیش‌فرض 0

footer

دکمه‌های پایین

نوع: ReactNode

dismissible

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

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

showClose

دکمهٔ بستن در سربرگ

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

متغیرهای CSS: --k-sheet-height، --k-sheet-radius و --k-dialog-width (بیشترین پهنا روی صفحهٔ بزرگ).

دسترس‌پذیری

  • همان رفتار دیالوگ: تلهٔ فوکوس، Esc و برگشت فوکوس پس از بستن.
  • کشیدن تنها راه نیست: Esc، کلیک روی پس‌زمینه و (با showClose) دکمهٔ بستن هم می‌بندند و دستگیره با کیبورد ارتفاع را عوض می‌کند.
  • دستگیرهٔ دارای ارتفاع، aria-expanded دارد و نامش «باز کردن کامل برگه» یا «کوچک کردن برگه» است.

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

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

  • انتخاب کوتاه در گوشی: مرتب‌سازی، اشتراک‌گذاری، انتخاب روش ارسال.
  • محتوایی که کاربر کنار صفحه نگاه می‌کند، مثل نظرها یا مسیر روی نقشه، با چند ارتفاع.

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

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

درست و نادرست

  1. درست
    درست: برای فهرست بلند snapPoints بدهید تا برگه نیمه باز شود و کاربر خودش بالا بکشد.
    نادرست
    نادرست: برگه‌ای که از اول تمام صفحه را می‌گیرد و صفحهٔ پشت دیده نمی‌شود؛ کاربر جایش را گم می‌کند.
  2. درست
    درست: در انتخاب تک‌گزینه‌ای، با انتخاب کاربر برگه را ببندید.
    نادرست
    نادرست: یک دکمهٔ «تأیید» اضافه بعد از انتخاب یک گزینهٔ ساده.