ComponentBố cục
Bắt đầu nhanh
Import OverlayControls 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 { OverlayControls } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử OverlayControls 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.
OverlayControls
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
modeBắt buộc | Chế độ: live/review. | "live" | "review" | Bắt buộc |
valueBắt buộc | Thời điểm hiện tại. | number | Bắt buộc |
maxBắt buộc | Tổng thời lượng. | number | Bắt buộc |
step | Bước seek. | number | 0.1 |
onChangeBắt buộc | Hàm thay đổi vị trí. | (v: number) => void | Bắt buộc |
onCommit | Hàm khi kết thúc kéo. | (v: number) => void | — |
playing | Đang phát (review). | boolean | false |
onTogglePlay | Bật/tắt phát. | () => void | — |
onGoLive | Chuyển về live. | () => void | — |
volume | Âm lượng 0..1. | number | — |
muted | Tắt tiếng. | boolean | — |
onVolumeChange | Thay đổi âm lượng. | (v: number) => void | — |
onToggleMute | Bật/tắt tiếng. | () => void | — |
rate | Tốc độ phát. | number | 1 |
onChangeRate | Thay đổi tốc độ. | (r: number) => void | — |
onToggleFullscreen | Bật/tắt toàn màn hình. | () => void | — |
showOnHover | Chỉ hiển thị khi hover. | boolean | false |
className | Class tuỳ chỉnh. | string | — |
showTime | Hiển thị thời gian hiện/tổng. | boolean | — |
skipSeconds | Số giây tua (review). | number | 10 |
onSkip | Callback tua tiến/lùi. | (seconds: number) => void | — |
onSeekPreview | Trả về URL ảnh preview theo thời gian. | (time: number) => string | undefined | — |
autoHide | Tự ẩn sau khi không thao tác. | boolean | false |
autoHideDelay | Độ trễ ẩn (ms). | number | 3000 |
enableKeyboardShortcuts | Bật phím tắt. | boolean | true |
Hướng dẫn sử dụng
Dùng OverlayControls để tạo phân cấp và nhịp điệu. Thay đổi responsive cần có chủ đích và không gây nhảy bố cục khi tải.
Trợ năng
Khi dùng OverlayControls, 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ế.