ComponentPhản hồi & Overlay

Modal

Modal thuộc nhóm Phản hồi & Overlay. Xem demo trực tiếp, cách tích hợp và các lưu ý triển khai.

Bắt đầu nhanh

Import Modal 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 { Modal } from '@underverse-ui/underverse';

Ví dụ tương tác

Dùng thử Modal thật, xem mã ví dụ và tra cứu các prop đã được mô tả.

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.

Component

Thuộc tính	Mô tả	Kiểu	Mặc định
`isOpen`Bắt buộc	Trạng thái mở/đóng modal.	`boolean`	`Bắt buộc`
`onClose`Bắt buộc	Hàm đóng modal.	`() => void`	`Bắt buộc`
`children`Bắt buộc	Nội dung modal.	`React.ReactNode`	`Bắt buộc`
`title`	Tiêu đề modal.	`string`	`—`
`description`	Mô tả ngắn trong header.	`string`	`—`
`className`	Mã nguồn chưa cung cấp mô tả bổ sung.	`string`	`—`
`contentClassName`	Class tuỳ biến cho vùng nội dung.	`string`	`—`
`overlayClassName`	Mã nguồn chưa cung cấp mô tả bổ sung.	`string`	`—`
`showCloseButton`	Hiển thị nút đóng (X).	`boolean`	`true`
`closeOnOverlayClick`	Click ra ngoài sẽ đóng.	`boolean`	`true`
`closeOnEsc`	Nhấn ESC để đóng.	`boolean`	`true`
`size`	Kích thước modal.	`"sm" \| "md" \| "lg" \| "xl" \| "full"`	`"md"`
`noPadding`	Tắt padding mặc định (hữu ích cho media).	`boolean`	`false`
`fullWidth`	Kéo modal full width, không margin hai bên.	`boolean`	`false`
`width`	Chiều rộng CSS (string hoặc number).	`string \| number`	`—`
`height`	Chiều cao CSS (string hoặc number).	`string \| number`	`—`
`borderMode`	Mã nguồn chưa cung cấp mô tả bổ sung.	`BorderMode`	`—`

Hướng dẫn sử dụng

Dùng Modal để 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 Modal, 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ế.

Toast Alert (with i18n)Tooltip