
Welcome to React Wheel Picker
A beautiful iOS-style wheel picker component for React with natural touch scrolling, smooth inertia effects, and infinite loop support. Perfect for building date pickers, selection menus, and any interface requiring an intuitive scrolling wheel.Installation
Get started with npm, yarn, or pnpm installation
Quick Start
Build your first wheel picker in minutes
Examples
Explore real-world examples and demos
API Reference
Complete API documentation and type definitions
Key Features
Natural Touch Scrolling
Natural Touch Scrolling
Smooth inertia scrolling with physics-based deceleration that feels just like iOS native pickers. Supports both touch and mouse interactions with drag gestures.
Infinite Loop Support
Infinite Loop Support
Enable seamless infinite scrolling for options that should wrap around. Perfect for time pickers and circular selections.
Fully Customizable Styling
Fully Customizable Styling
Unstyled components with complete control over appearance. Style with Tailwind CSS, CSS modules, or any styling solution. Includes data attributes and className props for flexible styling.
Keyboard Navigation
Keyboard Navigation
Accessibility First
Accessibility First
Built with accessibility in mind. Proper focus management, keyboard navigation, and ARIA attributes for screen readers.
Easy Integration
Easy Integration
Install via shadcn/ui CLI for quick setup, or use the primitives package for full control. Works with Next.js, Vite, and any React setup.
Simple Example
Here’s a basic example showing how easy it is to create a wheel picker:Why React Wheel Picker?
Performance
Optimized for smooth 60fps animations with efficient rendering
TypeScript
Fully typed with comprehensive TypeScript definitions
Framework Agnostic
Works with Next.js, Vite, Remix, or any React setup
Zero Dependencies
Lightweight with no external runtime dependencies
Controlled & Uncontrolled
Supports both controlled and uncontrolled component patterns
Active Development
Regularly updated with new features and improvements
Get Started
Community & Support
- GitHub: ncdai/react-wheel-picker
- Demo: react-wheel-picker.chanhdai.com
- Issues: Report bugs or request features
- Sponsor: Support the project
Ready to build?
Continue to installation to get started with React Wheel Picker
