رفتن به محتوای اصلی

کامپوننت‌ها

پنجرهٔ شناور

محتوای تعاملی کوتاه کنار یک دکمه، مثل فیلتر، فرم کوچک یا توضیح.

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

برخلاف Tooltip، داخل Popover می‌توان دکمه و فیلد گذاشت؛ برخلاف Dialog، بقیهٔ صفحه را مسدود نمی‌کند.

نمونه

<Popover title="فیلتر سفارش‌ها" trigger={<Button iconStart={<FilterIcon />}>فیلتر</Button>}>
<Checkbox label="پرداخت‌شده" />
…
</Popover>

<Popover placement="bottom-end" aria-label="دربارهٔ کارمزد"
trigger={<Button variant="tertiary">کارمزد چطور محاسبه می‌شود؟</Button>}>
کارمزد هر تراکنش ۱٪ مبلغ است.
</Popover>
نامنوعپیش‌فرضتوضیح
triggerReactElement—دکمهٔ باز کردن
titleReactNode—عنوان و نام پنجره
open / onOpenChangeboolean / (open) => void—حالت کنترل‌شده
placement"bottom-start" | "bottom-end" | "top-start" | "top-end""bottom-start"جای پنجره
aria-labelstring—نام پنجره وقتی title ندارد

دسترس‌پذیری

دکمه aria-haspopup="dialog" و aria-expanded می‌گیرد. با باز شدن، فوکوس به اولین عنصر داخل می‌رود؛ Esc می‌بندد و فوکوس را به دکمه برمی‌گرداند. کلیک بیرون یا رفتن فوکوس به بیرون هم پنجره را می‌بندد.