Toast
Đã cập nhậtToast 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 Toast từ entry của gói Free. 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ợ.
import { ToastProvider, useToast, Toast } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử Toast thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
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.
ToastProvider
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
childrenBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | React.ReactNode | Bắt buộc |
position | Vị trí hiển thị toast. | ToastPosition | "top-right" |
maxToasts | Số toast tối đa hiển thị. | number | 5 |
viewportClassName | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
showProgress | Ẩn/hiện thanh đếm thời gian (progress bar) của toast. | boolean | true |
duration | Default duration in milliseconds for toasts before auto-dismissing. Defaults to 5000. | number | — |
time | Alias for duration in milliseconds. Defaults to 5000. | number | — |
useToast
Hàm| API | Kiểu | Mô tả |
|---|---|---|
| useToast | () => ToastContextType | Mã nguồn chưa cung cấp mô tả bổ sung. |
Toast
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
id | Mã nguồn chưa cung cấp mô tả bổ sung. | string | "toast-standalone" |
onRemove | Mã nguồn chưa cung cấp mô tả bổ sung. | (id: string) => void | — |
onClose | Mã nguồn chưa cung cấp mô tả bổ sung. | () => void | — |
defaultShowProgress | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | true |
defaultDuration | Mã nguồn chưa cung cấp mô tả bổ sung. | number | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
typeBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | ToastType | Bắt buộc |
title | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
messageBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | string | Bắt buộc |
duration | Duration in milliseconds before auto-dismissal. 0 = persistent. | number | — |
time | Time in milliseconds before auto-dismissal (alias for duration). 0 = persistent. | number | — |
action | Mã nguồn chưa cung cấp mô tả bổ sung. | { label: string; onClick: () => void; } | — |
dismissible | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
overflowHidden | Cờ clip theo từng toast cho bề mặt ngoài. | boolean | — |
showProgress | Ẩn/hiện thanh đếm thời gian (progress bar) của toast. | boolean | — |
Hướng dẫn sử dụng
Dùng Toast để 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 Toast, 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ế.