Skip to content

dairondv1986/ionic-long-press

 
 

Repository files navigation

Ionic Long Press

Say you need to increment something quickly while pushing a button. Or something. This directive intends to build upon the existing Hammer.JS press event that Ionic uses for long pressing, by giving you interval emission.

Compatibility

This plugin should be compatible with Ionic and Angular 7+. It was tested with Ionic 4.11.5 and Angular 8.2.14.

Installation

npm install --save ionic-long-press

Include HammerJs in your Ionic project

Step 1

npm install --save hammerjs @types/hammerjs

Step 2

// in src/main.ts.
import 'hammerjs'

Step 3

Create an IonicGestureConfig.ts file in your utils folder and include this:

import { Injectable } from '@angular/core'
import { HammerGestureConfig } from '@angular/platform-browser'

/**
 * @hidden
 * This class overrides the default Angular gesture config.
 */
@Injectable()
export class IonicGestureConfig extends HammerGestureConfig {
  buildHammer(element: HTMLElement) {
    const mc = new (<any>window).Hammer(element)
    if (window) {
      for (const eventName in this.overrides) {
        if (eventName) {
          mc.get(eventName).set(this.overrides[eventName])
        }
      }
    }
    return mc;
  }
}

Step 4

// in app.module.ts
import { IonicGestureConfig } from '../utils/IonicGestureConfig'

Step 5

Add to provider:

@NgModule({
  imports: [
    ...
  ],
  declarations: [
    ...,
  ],
  providers: [{provide: HAMMER_GESTURE_CONFIG, useClass: IonicGestureConfig}],
})
export class MyModule {
}

Usage

The directive should work on any HTML element.

Import the module:

import { LongPressModule } from 'ionic-long-press';

@NgModule({
    imports: [
        ...
        LongPressModule
        ...
    ]
})

And use in your template:

<button ion-button ion-long-press [interval]="400" (pressed)="pressed()" (longPressed)="active()" (pressEnded)="released()"></button>

API

Item Description
ion-long-press Directive to include the press event outputs.
[interval] Number. Allows you to set the interval at which the longPressed event will fire. Default 500.
(pressed) Event fired when the element is initially pressed.
(longPressed) Event fired on the specified interval when the element is being held.
(pressEnded) Event fired when the element is released.

Caveats

I have instated a 40ms interval limit to prevent poor performance. I recommend a longer interval for heavy computations. If you need this limit lowered, please open an issue explaining your use case.

Credits

This plugin was originally developed by Wilson Hobbs in July 2017 with contributions from the open source community. Original source code is available for free on GitHub: https://github.com/wbhob/ionic-long-press

About

A little directive for long-press events on Ionic components

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 95.6%
  • JavaScript 4.4%