# Haptics

> Add iOS-style selection haptics to React Native wheel, time and date pickers with onValueChanging and expo-haptics or react-native-haptic-feedback.

Native wheels tick under your finger. Get the same feel with `onValueChanging`, which fires on **every row crossing** while scrolling, and on every step while dragging a slider. The library has no haptics dependency, so bring the one you already use.

## expo-haptics

```bash
npx expo install expo-haptics
```

```tsx
import * as Haptics from 'expo-haptics';
import { WheelPicker, TimePicker, DatePicker } from 'patine-ui';

const tick = () => Haptics.selectionAsync();

<WheelPicker items={items} value={v} onValueChange={setV} onValueChanging={tick} />
<TimePicker value={t} onValueChange={setT} onValueChanging={tick} />
<DatePicker display="wheel" value={d} onValueChange={setD} onValueChanging={tick} />
```

## react-native-haptic-feedback

```tsx
import ReactNativeHapticFeedback from 'react-native-haptic-feedback';

const tick = () => ReactNativeHapticFeedback.trigger('selection', { enableVibrateFallback: false });
<WheelPicker onValueChanging={tick} … />
```

## Confirm haptics

For a stronger buzz when a value is confirmed, use `onValueChange` or a sheet's `onConfirm`:

```tsx
<DatePickerSheet
  …
  onConfirm={(range) => {
    Haptics.notificationAsync(Haptics.NotificationFeedbackType.Success);
    setRange(range);
  }}
/>
```

## Which components support `onValueChanging`

| Component | Callback argument |
| --- | --- |
| `WheelPicker` | `(value, index)` |
| `MultiWheelPicker` columns | `(value, index)` per column |
| `TimePicker` / `TimePickerSheet` | `(date)` |
| `DateWheelPicker` / `DatePicker display="wheel"` | `(date)` |
| `DateTimePicker display="wheel"` / `DateTimePickerSheet` | `(date)` |
| `DurationPicker` / `DurationPickerSheet` | `(seconds)` |
| `WheelPickerSheet` | `(value, index)` |
| `Slider` | `(value)`, or `[start, end]` when `range` is set |

In the time, date and duration pickers it fires from the wheels only: a dial, number boxes or clickable columns don't call it. Disabled rows don't trigger it either.
