# Haptics

A provider that connects components to your haptics library, with a hook to trigger feedback.

Haptics is an open-source component from suiss/ui for React Native, SwiftUI and Jetpack Compose. The @esuiss/ui CLI copies its source into your project, so you own the code.

Source: https://ui.suiss.app/docs/components/haptics

**React Native, SwiftUI, Jetpack Compose**

![Preview](https://ui.suiss.app/previews/components-haptics--default.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Stepper, StepperDecrement, StepperGroup, StepperIncrement, StepperInput, StepperSeparator } from "@/components/interactions/stepper"
import { Checkbox } from "@/components/ui/checkbox"
import { Chip } from "@/components/ui/chip"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Slider } from "@/components/ui/slider"
import { Switch } from "@/components/ui/switch"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-muted px-4 py-3">
      <Text className="text-sm text-muted-foreground">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function Row({
  label,
  children,
}: {
  label: string
  children: React.ReactNode
}) {
  return (
    <View className="min-h-11 flex-row items-center justify-between gap-4">
      <Text>{label}</Text>
      {children}
    </View>
  )
}

function Controls() {
  const [wifi, setWifi] = React.useState(true)
  const [terms, setTerms] = React.useState(false)
  const [volume, setVolume] = React.useState(40)
  const [copies, setCopies] = React.useState(1)

  return (
    <View className="w-full gap-2">
      <Row label="Wi-Fi">
        <Switch
          accessibilityLabel="Wi-Fi"
          checked={wifi}
          onCheckedChange={setWifi}
        />
      </Row>
      <Row label="Accept terms">
        <Checkbox
          accessibilityLabel="Accept terms"
          checked={terms}
          onCheckedChange={setTerms}
        />
      </Row>
      <Row label="Copies">
        <Stepper value={copies} onValueChange={setCopies} min={1} max={9}>
          <StepperInput accessibilityLabel="Copies" />
          <StepperGroup>
            <StepperDecrement />
            <StepperSeparator />
            <StepperIncrement />
          </StepperGroup>
        </Stepper>
      </Row>
      <View className="flex-row gap-2 py-2">
        <Chip>Open now</Chip>
        <Chip>Top rated</Chip>
      </View>
      <Slider
        value={volume}
        step={10}
        onValueChange={(next) => setVolume(next)}
        accessibilityLabel="Volume"
      />
    </View>
  )
}

function ControlsDemo({ enabled = true }: { enabled?: boolean }) {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter} enabled={enabled}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <Controls />
      </View>
    </HapticsProvider>
  )
}

export function HapticsExample() {
  return (
    <ControlsDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsRow<Content: View>: View {
  let label: LocalizedStringKey
  @ViewBuilder let content: () -> Content

  var body: some View {
    HStack(spacing: 16) {
      Text(label)
        .textStyle(.base)
        .foregroundStyle(EsuissColor.foreground)
      Spacer(minLength: 0)
      content()
    }
    .frame(minHeight: 44)
  }
}

struct HapticsControls: View {
  @State private var wifi = true
  @State private var terms = false
  @State private var volume = 40.0
  @State private var copies = 1
  @State private var openNow = false
  @State private var topRated = false

  var body: some View {
    VStack(alignment: .leading, spacing: 8) {
      HapticsRow(label: "Wi-Fi") {
        Toggle(isOn: $wifi) { EmptyView() }
          .toggleStyle(.switch(size: .default))
          .accessibilityLabel(Text("Wi-Fi"))
      }
      HapticsRow(label: "Accept terms") {
        Toggle(isOn: $terms) { EmptyView() }
          .toggleStyle(.checkbox)
          .accessibilityLabel(Text("Accept terms"))
      }
      HapticsRow(label: "Copies") {
        ValueStepper(value: $copies, in: 1...9) {
          StepperInput()
            .accessibilityLabel(Text("Copies"))
          StepperGroup {
            StepperDecrement()
            StepperSeparator()
            StepperIncrement()
          }
        }
      }
      HStack(spacing: 8) {
        Chip("Open now", isSelected: $openNow)
        Chip("Top rated", isSelected: $topRated)
      }
      .padding(.vertical, 8)
      ValueSlider(value: $volume, in: 0...100, step: 10)
        .accessibilityLabel(Text("Volume"))
    }
    .frame(maxWidth: .infinity, alignment: .leading)
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.heightIn
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableDoubleStateOf
import androidx.compose.runtime.mutableFloatStateOf
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Checkbox
import com.esuiss.ui.components.Chip
import com.esuiss.ui.components.ProvideHaptics
import com.esuiss.ui.components.Slider
import com.esuiss.ui.components.Switch
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.Stepper
import com.esuiss.ui.interactions.StepperDecrement
import com.esuiss.ui.interactions.StepperGroup
import com.esuiss.ui.interactions.StepperIncrement
import com.esuiss.ui.interactions.StepperInput
import com.esuiss.ui.interactions.StepperSeparator
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

@Composable
fun HapticsExample() {
    HapticsControlsDemo(enabled = true)
}

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.muted, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.mutedForeground))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

@Composable
fun HapticsRow(label: String, content: @Composable () -> Unit) {
    Row(
        modifier = Modifier.fillMaxWidth().heightIn(min = 44.dp),
        horizontalArrangement = Arrangement.spacedBy(16.dp),
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text(label, modifier = Modifier.weight(1f))
        content()
    }
}

@Composable
fun HapticsControls() {
    var wifi by rememberSaveable { mutableStateOf(true) }
    var terms by rememberSaveable { mutableStateOf(false) }
    var volume by rememberSaveable { mutableFloatStateOf(40f) }
    var copies by rememberSaveable { mutableDoubleStateOf(1.0) }
    var openNow by rememberSaveable { mutableStateOf(false) }
    var topRated by rememberSaveable { mutableStateOf(false) }
    Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(8.dp)) {
        HapticsRow("Wi-Fi") {
            Switch(wifi, { wifi = it }, Modifier.semantics { contentDescription = "Wi-Fi" })
        }
        HapticsRow("Accept terms") {
            Checkbox(terms, { terms = it }, Modifier.semantics { contentDescription = "Accept terms" })
        }
        HapticsRow("Copies") {
            Stepper(copies, { copies = it }, min = 1.0, max = 9.0) {
                StepperInput(contentDescription = "Copies")
                StepperGroup {
                    StepperDecrement()
                    StepperSeparator()
                    StepperIncrement()
                }
            }
        }
        Row(Modifier.padding(vertical = 8.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
            Chip("Open now", openNow, { openNow = it })
            Chip("Top rated", topRated, { topRated = it })
        }
        Slider(volume, { volume = it }, step = 10f, contentDescription = "Volume")
    }
}

@Composable
fun HapticsControlsDemo(enabled: Boolean) {
    HapticsLogging { log ->
        ProvideHaptics(enabled = enabled) {
            Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
                HapticsLogRow(log)
                HapticsControls()
            }
        }
    }
}
```

Components such as Amount Input, Chart and Context Menu play haptic feedback through `useHaptics()`. By default nothing happens: `HapticsProvider` lets you plug in an adapter that calls the haptics library of your choice, so the components stay free of a native dependency.

The adapter has three methods: `impact(style)` with `light`, `medium`, `heavy`, `soft` or `rigid`; `selection()`; and `notification(type)` with `success`, `warning` or `error`.

## Installation

**React Native**

```bash title="Terminal"
npx shadcn@latest add @esuiss-rn/haptics
```

See [Installation](https://ui.suiss.app/docs/installation) for the `components.json` setup. Or use the suiss/ui CLI:

```bash title="Terminal"
npx @esuiss/ui@latest add haptics
```

**SwiftUI**

```bash title="Terminal"
npx @esuiss/ui@latest add haptics --platform swift
```

**Jetpack Compose**

```bash title="Terminal"
npx @esuiss/ui@latest add haptics --platform kotlin
```

### Manual

**React Native**

**Uniwind**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="uniwind/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**NativeWind**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="nativewind/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**StyleSheet**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="stylesheet/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**SwiftUI**

1. Target iOS 17 or later.

2. Copy the theme files every view uses:

- `swift/Theme/Theme.swift`: [source](https://github.com/e-suiss/ui/blob/main/packages/mobile/swiftui/Sources/EsuissUI/Theme/Theme.swift)

- `swift/Theme/Tokens.swift`: [source](https://github.com/e-suiss/ui/blob/main/packages/mobile/swiftui/Sources/EsuissUI/Theme/Tokens.swift)

3. Copy the source:

```swift title="swift/Components/Haptics.swift"
import SwiftUI

extension EnvironmentValues {
  @Entry public var hapticsEnabled = true
}

extension View {
  public func haptics(_ enabled: Bool) -> some View {
    environment(\.hapticsEnabled, enabled)
  }

  func hapticFeedback<Trigger: Equatable>(_ feedback: SensoryFeedback, trigger: Trigger) -> some View {
    modifier(HapticFeedbackModifier(feedback: feedback, trigger: trigger) { _, _ in true })
  }

  func hapticFeedback<Trigger: Equatable>(
    _ feedback: SensoryFeedback,
    trigger: Trigger,
    condition: @escaping (Trigger, Trigger) -> Bool
  ) -> some View {
    modifier(HapticFeedbackModifier(feedback: feedback, trigger: trigger, condition: condition))
  }
}

private struct HapticFeedbackModifier<Trigger: Equatable>: ViewModifier {
  let feedback: SensoryFeedback
  let trigger: Trigger
  let condition: (Trigger, Trigger) -> Bool

  @Environment(\.hapticsEnabled) private var enabled

  func body(content: Content) -> some View {
    let enabled = enabled
    let condition = condition
    content.sensoryFeedback(feedback, trigger: trigger) { old, new in
      enabled && condition(old, new)
    }
  }
}

enum HapticMoments {
  static func step(_ value: Double, bounds: ClosedRange<Double>, step: Double?) -> Int? {
    guard let step, step > 0 else { return nil }
    return Int(((value - bounds.lowerBound) / step).rounded())
  }

  static func lifted<Value: Equatable>(_ old: Value?, _ new: Value?) -> Bool {
    new != nil && old != new
  }

  static func crossed<Value: Equatable>(_ old: Value?, _ new: Value?) -> Bool {
    old == nil && new != nil
  }

  static func moved(_ old: Int?, _ new: Int?) -> Bool {
    guard let old, let new else { return false }
    return old != new
  }
}

struct HapticButton<Style: ButtonStyle>: View {
  let feedback: SensoryFeedback
  let action: () -> Bool
  let style: Style

  @State private var count = 0

  init(_ feedback: SensoryFeedback = .selection, style: Style, action: @escaping () -> Bool) {
    self.feedback = feedback
    self.style = style
    self.action = action
  }

  var body: some View {
    Button {
      if action() { count += 1 }
    } label: {
      EmptyView()
    }
    .buttonStyle(style)
    .hapticFeedback(feedback, trigger: count)
  }
}
```

4. Add the files to your app target.

**Jetpack Compose**

1. Set `minSdk` to 24 or higher and add the dependencies:

```kotlin title="build.gradle.kts"
implementation(platform("androidx.compose:compose-bom:2026.09.00"))
implementation("androidx.compose.foundation:foundation")
implementation("androidx.compose.ui:ui")
```

2. Copy the theme files every view uses:

- `kotlin/theme/Theme.kt`: [source](https://github.com/e-suiss/ui/blob/main/packages/mobile/kotlin/ui/src/main/kotlin/com/esuiss/ui/theme/Theme.kt)

- `kotlin/theme/Tokens.kt`: [source](https://github.com/e-suiss/ui/blob/main/packages/mobile/kotlin/ui/src/main/kotlin/com/esuiss/ui/theme/Tokens.kt)

3. Copy the source:

```kt title="kotlin/components/Haptics.kt"
package com.esuiss.ui.components

import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.remember
import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback

val LocalHapticsEnabled = staticCompositionLocalOf { true }

@Composable
fun ProvideHaptics(enabled: Boolean, content: @Composable () -> Unit) {
    CompositionLocalProvider(LocalHapticsEnabled provides enabled, content = content)
}

internal class Haptics(private val feedback: HapticFeedback, private val enabled: Boolean) {
    fun perform(type: HapticFeedbackType) {
        if (enabled) feedback.performHapticFeedback(type)
    }

    fun toggle(on: Boolean) = perform(if (on) HapticFeedbackType.ToggleOn else HapticFeedbackType.ToggleOff)

    fun selection() = perform(HapticFeedbackType.SegmentTick)
}

@Composable
internal fun rememberHaptics(): Haptics {
    val feedback = LocalHapticFeedback.current
    val enabled = LocalHapticsEnabled.current
    return remember(feedback, enabled) { Haptics(feedback, enabled) }
}
```

4. Update the `com.esuiss.ui` package names to match your project.

## Usage

```tsx
import { HapticsProvider } from "@/components/ui/haptics"
```

```tsx
<ControlsDemo />
```

Wrap your app in `HapticsProvider` and pass an `adapter` object that implements `impact`, `selection` and `notification`. Set `enabled={false}` to turn all feedback off, for example from a user setting.

Call `useHaptics()` in your own components to get the same methods. Without a provider, or when disabled, they do nothing.

## Examples

**React Native, SwiftUI**

### Feedback

Buttons for each impact, selection and notification type.

![Preview](https://ui.suiss.app/previews/components-haptics--feedback.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { type HapticsAdapter, HapticsProvider, useHaptics } from "@/components/ui/haptics"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-muted px-4 py-3">
      <Text className="text-sm text-muted-foreground">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function FeedbackButtons() {
  const haptics = useHaptics()
  return (
    <View className="w-full gap-3">
      <Text variant="muted">Impact</Text>
      <View className="flex-row flex-wrap gap-2">
        {(["light", "medium", "heavy", "soft", "rigid"] as const).map(
          (style) => (
            <Button
              key={style}
              size="sm"
              variant="secondary"
              onPress={() => haptics.impact(style)}
            >
              {style}
            </Button>
          )
        )}
      </View>
      <Text variant="muted">Selection</Text>
      <View className="flex-row flex-wrap gap-2">
        <Button
          size="sm"
          variant="secondary"
          onPress={() => haptics.selection()}
        >
          selection
        </Button>
      </View>
      <Text variant="muted">Notification</Text>
      <View className="flex-row flex-wrap gap-2">
        {(["success", "warning", "error"] as const).map((type) => (
          <Button
            key={type}
            size="sm"
            variant="secondary"
            onPress={() => haptics.notification(type)}
          >
            {type}
          </Button>
        ))}
      </View>
    </View>
  )
}

function FeedbackDemo() {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <FeedbackButtons />
      </View>
    </HapticsProvider>
  )
}

export function HapticsFeedbackExample() {
  return (
    <FeedbackDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsLog: View {
  let last: String
  let count: Int

  var body: some View {
    HStack {
      Text("Last haptic")
        .textStyle(.sm)
        .foregroundStyle(EsuissColor.mutedForeground)
      Spacer(minLength: 16)
      Text(verbatim: count > 0 ? "\(last) (\(count))" : last)
        .textStyle(.sm, weight: .medium)
        .foregroundStyle(EsuissColor.foreground)
        .accessibilityAddTraits(.updatesFrequently)
    }
    .padding(.horizontal, 16)
    .padding(.vertical, 12)
    .background(EsuissColor.muted, in: RoundedRectangle(cornerRadius: Radius.xl, style: .continuous))
  }
}

struct HapticsFeedbackDemo: View {
  struct Entry: Identifiable {
    let id: String
    let feedback: SensoryFeedback
  }

  private static let impacts = [
    Entry(id: "light", feedback: .impact(weight: .light)),
    Entry(id: "medium", feedback: .impact(weight: .medium)),
    Entry(id: "heavy", feedback: .impact(weight: .heavy)),
    Entry(id: "soft", feedback: .impact(flexibility: .soft)),
    Entry(id: "rigid", feedback: .impact(flexibility: .rigid)),
  ]

  private static let notifications = [
    Entry(id: "success", feedback: .success),
    Entry(id: "warning", feedback: .warning),
    Entry(id: "error", feedback: .error),
  ]

  @State private var last = "None"
  @State private var count = 0

  var body: some View {
    VStack(alignment: .leading, spacing: 16) {
      HapticsLog(last: last, count: count)
      VStack(alignment: .leading, spacing: 12) {
        Text("Impact").textVariant(.muted)
        FlowRow(spacing: 8) {
          ForEach(Self.impacts) { entry in
            HapticsFeedbackButton(title: entry.id, feedback: entry.feedback) { record("impact \(entry.id)") }
          }
        }
        Text("Selection").textVariant(.muted)
        FlowRow(spacing: 8) {
          HapticsFeedbackButton(title: "selection", feedback: .selection) { record("selection") }
        }
        Text("Notification").textVariant(.muted)
        FlowRow(spacing: 8) {
          ForEach(Self.notifications) { entry in
            HapticsFeedbackButton(title: entry.id, feedback: entry.feedback) { record("notification \(entry.id)") }
          }
        }
      }
    }
  }

  func record(_ event: String) {
    last = event
    count += 1
  }
}

struct HapticsFeedbackButton: View {
  let title: String
  let feedback: SensoryFeedback
  let action: () -> Void

  @State private var trigger = 0

  var body: some View {
    Button(title) {
      trigger += 1
      action()
    }
    .buttonStyle(.variant(.secondary, size: .sm))
    .sensoryFeedback(feedback, trigger: trigger)
  }
}

let impacts = [
  Entry(id: "light", feedback: .impact(weight: .light)),
  Entry(id: "medium", feedback: .impact(weight: .medium)),
  Entry(id: "heavy", feedback: .impact(weight: .heavy)),
  Entry(id: "soft", feedback: .impact(flexibility: .soft)),
  Entry(id: "rigid", feedback: .impact(flexibility: .rigid)),
]

let notifications = [
  Entry(id: "success", feedback: .success),
  Entry(id: "warning", feedback: .warning),
  Entry(id: "error", feedback: .error),
]
```

### Reorder

Feedback while dragging items in a reorder list.

![Preview](https://ui.suiss.app/previews/components-haptics--reorder.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { ReorderList, ReorderListHandle, ReorderListItem } from "@/components/interactions/reorder-list"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-muted px-4 py-3">
      <Text className="text-sm text-muted-foreground">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

const tasks = ["Inbox", "Today", "Upcoming", "Someday"]

function ReorderDemo() {
  const { adapter, log } = useLoggingAdapter()
  const [value, setValue] = React.useState(tasks)
  return (
    <HapticsProvider adapter={adapter}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <ReorderList
          value={value}
          onValueChange={setValue}
          className="overflow-hidden rounded-2xl border border-border"
        >
          {value.map((task) => (
            <ReorderListItem key={task} value={task} className="ps-4">
              <View className="min-w-0 grow py-3">
                <Text numberOfLines={1}>{task}</Text>
              </View>
              <ReorderListHandle accessibilityLabel={`Reorder ${task}`} />
            </ReorderListItem>
          ))}
        </ReorderList>
      </View>
    </HapticsProvider>
  )
}

export function HapticsReorderExample() {
  return (
    <ReorderDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsReorderDemo: View {
  @State private var tasks = ["Inbox", "Today", "Upcoming", "Someday"]

  var body: some View {
    ReorderList($tasks) { task in
      Text(verbatim: task)
        .textStyle(.base)
        .foregroundStyle(EsuissColor.foreground)
        .lineLimit(1)
        .padding(.vertical, 12)
    }
    .clipShape(RoundedRectangle(cornerRadius: Radius.xl2, style: .continuous))
    .overlay {
      RoundedRectangle(cornerRadius: Radius.xl2, style: .continuous)
        .strokeBorder(EsuissColor.border)
    }
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.ReorderList
import com.esuiss.ui.interactions.ReorderListHandle
import com.esuiss.ui.interactions.ReorderListItem
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.muted, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.mutedForeground))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

val HapticsTasks = listOf("Inbox", "Today", "Upcoming", "Someday")

@Composable
fun HapticsReorderDemo() {
    var value by rememberSaveable { mutableStateOf(HapticsTasks) }
    val shape = RoundedCornerShape(Radius.xl2)
    HapticsLogging { log ->
        Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
            HapticsLogRow(log)
            ReorderList(
                value,
                { value = it },
                modifier = Modifier
                    .fillMaxWidth()
                    .clip(shape)
                    .border(1.dp, EsuissTheme.colors.border, shape),
            ) { task ->
                ReorderListItem {
                    Text(
                        task,
                        modifier = Modifier.weight(1f).padding(vertical = 12.dp),
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis,
                    )
                    ReorderListHandle(contentDescription = "Reorder $task")
                }
            }
        }
    }
}
```

### Disabled

The same controls with haptics turned off.

![Preview](https://ui.suiss.app/previews/components-haptics--disabled.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Stepper, StepperDecrement, StepperGroup, StepperIncrement, StepperInput, StepperSeparator } from "@/components/interactions/stepper"
import { Checkbox } from "@/components/ui/checkbox"
import { Chip } from "@/components/ui/chip"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Slider } from "@/components/ui/slider"
import { Switch } from "@/components/ui/switch"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-muted px-4 py-3">
      <Text className="text-sm text-muted-foreground">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function Row({
  label,
  children,
}: {
  label: string
  children: React.ReactNode
}) {
  return (
    <View className="min-h-11 flex-row items-center justify-between gap-4">
      <Text>{label}</Text>
      {children}
    </View>
  )
}

function Controls() {
  const [wifi, setWifi] = React.useState(true)
  const [terms, setTerms] = React.useState(false)
  const [volume, setVolume] = React.useState(40)
  const [copies, setCopies] = React.useState(1)

  return (
    <View className="w-full gap-2">
      <Row label="Wi-Fi">
        <Switch
          accessibilityLabel="Wi-Fi"
          checked={wifi}
          onCheckedChange={setWifi}
        />
      </Row>
      <Row label="Accept terms">
        <Checkbox
          accessibilityLabel="Accept terms"
          checked={terms}
          onCheckedChange={setTerms}
        />
      </Row>
      <Row label="Copies">
        <Stepper value={copies} onValueChange={setCopies} min={1} max={9}>
          <StepperInput accessibilityLabel="Copies" />
          <StepperGroup>
            <StepperDecrement />
            <StepperSeparator />
            <StepperIncrement />
          </StepperGroup>
        </Stepper>
      </Row>
      <View className="flex-row gap-2 py-2">
        <Chip>Open now</Chip>
        <Chip>Top rated</Chip>
      </View>
      <Slider
        value={volume}
        step={10}
        onValueChange={(next) => setVolume(next)}
        accessibilityLabel="Volume"
      />
    </View>
  )
}

function ControlsDemo({ enabled = true }: { enabled?: boolean }) {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter} enabled={enabled}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <Controls />
      </View>
    </HapticsProvider>
  )
}

export function HapticsDisabledExample() {
  return (
    <ControlsDemo enabled={false} />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsDisabledExample: View {
  var body: some View {
    HapticsControls()
      .haptics(false)
  }
}

struct HapticsRow<Content: View>: View {
  let label: LocalizedStringKey
  @ViewBuilder let content: () -> Content

  var body: some View {
    HStack(spacing: 16) {
      Text(label)
        .textStyle(.base)
        .foregroundStyle(EsuissColor.foreground)
      Spacer(minLength: 0)
      content()
    }
    .frame(minHeight: 44)
  }
}

struct HapticsControls: View {
  @State private var wifi = true
  @State private var terms = false
  @State private var volume = 40.0
  @State private var copies = 1
  @State private var openNow = false
  @State private var topRated = false

  var body: some View {
    VStack(alignment: .leading, spacing: 8) {
      HapticsRow(label: "Wi-Fi") {
        Toggle(isOn: $wifi) { EmptyView() }
          .toggleStyle(.switch(size: .default))
          .accessibilityLabel(Text("Wi-Fi"))
      }
      HapticsRow(label: "Accept terms") {
        Toggle(isOn: $terms) { EmptyView() }
          .toggleStyle(.checkbox)
          .accessibilityLabel(Text("Accept terms"))
      }
      HapticsRow(label: "Copies") {
        ValueStepper(value: $copies, in: 1...9) {
          StepperInput()
            .accessibilityLabel(Text("Copies"))
          StepperGroup {
            StepperDecrement()
            StepperSeparator()
            StepperIncrement()
          }
        }
      }
      HStack(spacing: 8) {
        Chip("Open now", isSelected: $openNow)
        Chip("Top rated", isSelected: $topRated)
      }
      .padding(.vertical, 8)
      ValueSlider(value: $volume, in: 0...100, step: 10)
        .accessibilityLabel(Text("Volume"))
    }
    .frame(maxWidth: .infinity, alignment: .leading)
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.heightIn
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableDoubleStateOf
import androidx.compose.runtime.mutableFloatStateOf
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Checkbox
import com.esuiss.ui.components.Chip
import com.esuiss.ui.components.ProvideHaptics
import com.esuiss.ui.components.Slider
import com.esuiss.ui.components.Switch
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.Stepper
import com.esuiss.ui.interactions.StepperDecrement
import com.esuiss.ui.interactions.StepperGroup
import com.esuiss.ui.interactions.StepperIncrement
import com.esuiss.ui.interactions.StepperInput
import com.esuiss.ui.interactions.StepperSeparator
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

@Composable
fun HapticsDisabledExample() {
    HapticsControlsDemo(enabled = false)
}

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.muted, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.mutedForeground))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

@Composable
fun HapticsRow(label: String, content: @Composable () -> Unit) {
    Row(
        modifier = Modifier.fillMaxWidth().heightIn(min = 44.dp),
        horizontalArrangement = Arrangement.spacedBy(16.dp),
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text(label, modifier = Modifier.weight(1f))
        content()
    }
}

@Composable
fun HapticsControls() {
    var wifi by rememberSaveable { mutableStateOf(true) }
    var terms by rememberSaveable { mutableStateOf(false) }
    var volume by rememberSaveable { mutableFloatStateOf(40f) }
    var copies by rememberSaveable { mutableDoubleStateOf(1.0) }
    var openNow by rememberSaveable { mutableStateOf(false) }
    var topRated by rememberSaveable { mutableStateOf(false) }
    Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(8.dp)) {
        HapticsRow("Wi-Fi") {
            Switch(wifi, { wifi = it }, Modifier.semantics { contentDescription = "Wi-Fi" })
        }
        HapticsRow("Accept terms") {
            Checkbox(terms, { terms = it }, Modifier.semantics { contentDescription = "Accept terms" })
        }
        HapticsRow("Copies") {
            Stepper(copies, { copies = it }, min = 1.0, max = 9.0) {
                StepperInput(contentDescription = "Copies")
                StepperGroup {
                    StepperDecrement()
                    StepperSeparator()
                    StepperIncrement()
                }
            }
        }
        Row(Modifier.padding(vertical = 8.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
            Chip("Open now", openNow, { openNow = it })
            Chip("Top rated", topRated, { topRated = it })
        }
        Slider(volume, { volume = it }, step = 10f, contentDescription = "Volume")
    }
}

@Composable
fun HapticsControlsDemo(enabled: Boolean) {
    HapticsLogging { log ->
        ProvideHaptics(enabled = enabled) {
            Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
                HapticsLogRow(log)
                HapticsControls()
            }
        }
    }
}
```

## API Reference

### HapticsProvider

Supplies the adapter to every component below it.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `adapter` | `HapticsAdapter \| null` | - | Object with `impact`, `selection` and `notification` methods. |
| `enabled` | `boolean` | `true` | Turns feedback on or off. Defaults to `true`. |
| `children` | `React.ReactNode` | - |  |

## Notes

- The types `HapticsAdapter`, `HapticsImpactStyle` and `HapticsNotificationType` are exported for typing your adapter.
- Haptics have no visual output; pair important feedback with a visible change.