Time Picker
Component time picker để chọn giá trị giờ.
Cài đặt
bash
npx @galaxy-stack/nebula-cli@latest add time-pickerbash
pnpm dlx @galaxy-stack/nebula-cli@latest add time-pickerbash
yarn dlx @galaxy-stack/nebula-cli@latest add time-pickerbash
bunx @galaxy-stack/nebula-cli@latest add time-pickerbash
# Nếu bạn đã cài đặt galaxy-design toàn cục
galaxy-design add time-pickerDependencies
Component này tự động cài đặt các dependencies sau:
- React:
class-variance-authority - Vue:
class-variance-authority - Angular:
class-variance-authority - React Native: Không khả dụng (sử dụng native picker)
- Flutter: Không khả dụng (sử dụng TimePicker có sẵn)
Không cần cài đặt thủ công!
Sử dụng
Ví dụ cơ bản
tsx
import { TimePicker } from "@/components/ui/time-picker"
export default function TimePickerDemo() {
return <TimePicker placeholder="Chọn giờ" />
}vue
<script setup lang="ts">
import { TimePicker } from '@/components/ui/time-picker'
</script>
<template>
<TimePicker placeholder="Chọn giờ" />
</template>Định dạng 12 giờ
tsx
import { TimePicker } from "@/components/ui/time-picker"
export default function TimePicker12h() {
return <TimePicker placeholder="Chọn giờ" format="12h" />
}vue
<script setup lang="ts">
import { TimePicker } from '@/components/ui/time-picker'
</script>
<template>
<TimePicker placeholder="Chọn giờ" format="12h" />
</template>API Reference
Props
| Prop | Type | Default | Description | Framework Support |
|---|---|---|---|---|
time | Date | undefined | Giờ đã chọn | Tất cả |
defaultTime | Date | undefined | Giờ mặc định | Tất cả |
placeholder | string | 'Chọn giờ' | Văn bản giữ chỗ | Tất cả |
disabled | boolean | false | Vô hiệu picker | Tất cả |
format | `'12h' | '24h'` | '24h' | Định dạng giờ |
className / class | string | '' | Tên class CSS | Tất cả |
clearable | boolean | true | Hiển thị nút xóa | Tất cả |
Accessibility
- Keyboard Navigation: Phím mũi tên để điều chỉnh giờ, Enter để xác nhận
- Screen Reader: Sử dụng ARIA labels và live regions phù hợp
- Focus Management: Focus trap trong dropdown
- WCAG Compliance: Tuân thủ WCAG 2.1 Level AA
Author
Bùi Trọng Hiếu (kevinbui)
- GitHub: @buikevin
- Email: kevinbui210191@gmail.com
License
MIT © 2025 Bùi Trọng Hiếu (kevinbui)
