ionic4-long-press
v1.0.6
Published
A little plugin to add long-press events to ionic components
Downloads
54
Readme
Ionic 4 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.6.0 and Angular 7.2.2.
Installation
npm install --save ionic4-long-press
Include HammerJs in your Ionic project
step 1:
npm install --save hammerjs @types/hammerjs
step 2:
import HammerJs in src/main.ts. i.e import 'hammerjs'; // HAMMER TIME
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);
for (const eventName in this.overrides) {
if (eventName) {
mc.get(eventName).set(this.overrides[eventName]);
}
}
return mc;
}
}
step 4: In your app.module.ts import {IonicGestureConfig} from "../utils/IonicGestureConfig"; and 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 'ionic4-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 and updated for Ionic 4 by Robin Giel in September 2019.