ComponentPhản hồi & Overlay
Bắt đầu nhanh
Import Popover từ entry công khai. Các ví dụ bên dưới thể hiện những kiểu tương tác và cấu hình được hỗ trợ.
component.tsxtsx
import { Popover } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử Popover thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
Đang tải ví dụ tương tác…
Tham chiếu
Tham chiếu API
Tra cứu các thuộc tính, kiểu dữ liệu được chấp nhận, giá trị mặc định và lưu ý về hành vi.
Dữ liệu được sinh từ API TypeScript công khai của thư viện. Kiểu dữ liệu, thuộc tính bắt buộc và giá trị mặc định luôn đồng bộ với mã nguồn.
Popover
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
triggerBắt buộc | Phần tử trigger (nút/liên kết). | React.ReactElement | Bắt buộc |
childrenBắt buộc | Nội dung bên trong popover. | React.ReactNode | Bắt buộc |
className | Class tuỳ chỉnh cho wrapper. | string | — |
contentClassName | Class tuỳ chỉnh cho khung nội dung. | string | — |
contentProps | Mã nguồn chưa cung cấp mô tả bổ sung. | React.HTMLAttributes<HTMLDivElement> | — |
contentScrollable | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
placement | Vị trí quanh trigger. | PopoverPlacement | "bottom" |
modal | Chế độ modal (aria-modal). | boolean | false |
disabled | Vô hiệu hoá mở. | boolean | false |
open | Trạng thái mở (controlled). | boolean | — |
onOpenChange | Callback khi trạng thái mở thay đổi. | (open: boolean) => void | — |
matchTriggerWidth | Khớp chiều rộng với trigger. | boolean | false |
contentWidth | Chiều rộng cố định (px). | number | — |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
getPortalContainer | Resolve the document element that should receive the portal. | () => HTMLElement | null | — |
constrainToAvailableHeight | Constrain vertical placement and height to the largest available viewport side. | boolean | false |
Hướng dẫn sử dụng
Dùng Popover để thông báo thay đổi trạng thái đúng lúc mà không làm gián đoạn tác vụ. Nội dung nên ngắn và focus phải quay về vị trí hợp lý.
Trợ năng
Khi dùng Popover, hãy giữ trạng thái focus dễ nhận biết, cung cấp tên truy cập khi cần và kiểm tra bàn phím cùng trình đọc màn hình trong ngữ cảnh thực tế.