ember-capacitor-haptics

Haptics Capacitor plugin as Ember Service.

Compatibility

• Ember.js v3.28 or above
• Ember CLI v3.28 or above
• Node.js v14 or above

Installation

ember install @ember-capacitor/haptics

Usage

import Component from '@glimmer/component';
import { inject as service } from '@ember/service';
import { action } from '@ember/object';

import { ImpactStyle } from 'ember-capacitor-haptics/services/capacitor-haptics';

export default class MyComponent extends Component {
  @service haptics;

  @action
  async vibrate() {
    await this.haptics.vibrate(ImpactStyle.Heavy);
  }
}

API

• impact(...)
• notification(...)
• vibrate(...)
• selectionStart()
• selectionChanged()
• selectionEnd()
• Interfaces
• Enums

impact(...)

impact(options?: ImpactOptions | undefined) => Promise<void>

Trigger a haptics "impact" feedback

| Param | Type | | ------------- | ------------------------------------------------------- | | options | ImpactOptions |

Since: 1.0.0

notification(...)

notification(options?: NotificationOptions | undefined) => Promise<void>

Trigger a haptics "notification" feedback

| Param | Type | | ------------- | ------------------------------------------------------------------- | | options | NotificationOptions |

Since: 1.0.0

vibrate(...)

vibrate(options?: VibrateOptions | undefined) => Promise<void>

Vibrate the device

| Param | Type | | ------------- | --------------------------------------------------------- | | options | VibrateOptions |

Since: 1.0.0

selectionStart()

selectionStart() => Promise<void>

Trigger a selection started haptic hint

Since: 1.0.0

selectionChanged()

selectionChanged() => Promise<void>

Trigger a selection changed haptic hint. If a selection was started already, this will cause the device to provide haptic feedback

Since: 1.0.0

selectionEnd()

selectionEnd() => Promise<void>

If selectionStart() was called, selectionEnd() ends the selection. For example, call this when a user has lifted their finger from a control

Since: 1.0.0

Interfaces

ImpactOptions

| Prop | Type | Description | Default | Since | | ----------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | ----- | | style | ImpactStyle | Impact Feedback Style The mass of the objects in the collision simulated by a UIImpactFeedbackGenerator object. | ImpactStyle.Heavy | 1.0.0 |

NotificationOptions

| Prop | Type | Description | Default | Since | | ---------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ----- | | type | NotificationType | Notification Feedback Type The type of notification feedback generated by a UINotificationFeedbackGenerator object. | NotificationType.SUCCESS | 1.0.0 |

VibrateOptions

| Prop | Type | Description | Default | Since | | -------------- | ------------------- | ------------------------------------------ | ---------------- | ----- | | duration | number | Duration of the vibration in milliseconds. | 300 | 1.0.0 |

Enums

ImpactStyle

| Members | Value | Description | Since | | ------------ | --------------------- | ------------------------------------------------------------ | ----- | | Heavy | 'HEAVY' | A collision between large, heavy user interface elements | 1.0.0 | | Medium | 'MEDIUM' | A collision between moderately sized user interface elements | 1.0.0 | | Light | 'LIGHT' | A collision between small, light user interface elements | 1.0.0 |

NotificationType

| Members | Value | Description | Since | | ------------- | ---------------------- | ------------------------------------------------------------------------------ | ----- | | Success | 'SUCCESS' | A notification feedback type indicating that a task has completed successfully | 1.0.0 | | Warning | 'WARNING' | A notification feedback type indicating that a task has produced a warning | 1.0.0 | | Error | 'ERROR' | A notification feedback type indicating that a task has failed | 1.0.0 |

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.