Haptica

Haptica is a simple and expressive haptic feedback generator for iOS.

$ pod try Haptica

📱 Requirements

| Haptica Version | iOS | Swift | Xcode | |-----------------|-----|-------|--------| | 4.x | 13+ | 5.x | 11+ | | 3.x | 9+ | 5.x | 8+ | | 2.x | 9+ | 4.x | 8+ | | 1.x | 9+ | 3.x | 8+ |

Haptic Feedback Requirements

Device with a supported Taptic Engine
App running in the foreground
System Haptics setting enabled

🚀 Usage

Trigger a haptic feedback with a single line:

Haptic.impact(.light).generate()

Feedback Types

Impact (.light, .medium, .heavy, .soft, .rigid)

Use to indicate collision or snap-to-position.

Notification (.success, .warning, .error)

Use to communicate task results.

Selection

Use for navigation through discrete values.

Semantic Types (New)

Use new expressive variants for common interactions:

Haptic.success.generate()
Haptic.warning.generate()
Haptic.start.generate()
Haptic.stop.generate()
Haptic.increase.generate()
Haptic.decrease.generate()

These semantic styles internally map to appropriate UIKit or Core Haptics-based effects.

Custom Vibration Patterns

Haptic.play("..oO-Oo..", delay: 0.1)

| Symbol | Feedback Type | |--------|-----------------| | . | Light impact | | o | Medium impact | | O | Heavy impact | | x | Soft impact | | X | Rigid impact | | - | 0.1s pause |

Or use structured notes:

Haptic.play([
    .haptic(.impact(.light)),
    .haptic(.impact(.heavy)),
    .wait(0.1),
    .haptic(.impact(.heavy)),
    .haptic(.impact(.light))
])

🔧 Core Haptics Support

Haptica uses Core Haptics by default when available. To use the legacy API:

Haptic.play(notes, legacy: true)

📂 Play from Pattern File (New) - iOS 16+

Play a Core Haptics pattern from a bundled .ahap file:

Haptic.playPattern(named: "Feedback")

Make sure the file is included in your app bundle and contains a valid haptic pattern.

🧹 UIButton Extension

Enable haptics for buttons easily:

button.isHaptic = true
button.hapticType = .impact(.light)

Add or remove haptic feedback on control events:

button.addHaptic(.selection, forControlEvents: .touchDown)
button.removeHaptic(forControlEvents: .touchDown)

API Summary:

var isHaptic: Bool
var hapticType: Haptic?
var hapticControlEvents: UIControl.Event?
func addHaptic(_ haptic: Haptic, forControlEvents events: UIControl.Event) func removeHaptic(forControlEvents events: UIControl.Event)