Skip to content

Time Picker

Component time picker để chọn giá trị giờ.

Cài đặt

bash
npx @galaxy-stack/nebula-cli@latest add time-picker
bash
pnpm dlx @galaxy-stack/nebula-cli@latest add time-picker
bash
yarn dlx @galaxy-stack/nebula-cli@latest add time-picker
bash
bunx @galaxy-stack/nebula-cli@latest add time-picker
bash
# Nếu bạn đã cài đặt galaxy-design toàn cục
galaxy-design add time-picker

Dependencies

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

PropTypeDefaultDescriptionFramework Support
timeDateundefinedGiờ đã chọnTất cả
defaultTimeDateundefinedGiờ mặc địnhTất cả
placeholderstring'Chọn giờ'Văn bản giữ chỗTất cả
disabledbooleanfalseVô hiệu pickerTất cả
format`'12h''24h'`'24h'Định dạng giờ
className / classstring''Tên class CSSTất cả
clearablebooleantrueHiển thị nút xóaTấ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)

License

MIT © 2025 Bùi Trọng Hiếu (kevinbui)

Phát hành theo Giấy phép MIT.