How to close Ionic modals using the hardware back button

May 06, 2019

#webdev #ionic #angular #stencil

I noticed today that I’m always reusing the exact same piece of code in order to close Ionic modals using the Android hardware back button. Moreover, as I wrote a couple of months ago a blog post about “How to declare and use modals in Ionic v4”, I thought that displaying quickly how I solve this would be a nice add-on.

Actually, I have implemented two different solutions for my applications. One for my Angular applications and one for the [StencilJS] ( one, therefore I’ll showcase both pieces of code 😋


I just tested again to be sure (today is the 6th May 2019), the solution I display using Angular works fine for Android applications but doesn’t for Progressive Web Apps.

Contrariwise the solution I display using StencilJS works like a charm for PWA. According your need, you might use one, the other or “a bit of both” as Star Lord would do 😉

Of course, if you would have a better solution which works for all cases, don’t hesitate to ping as the solutions I’m displaying are implemented in “real” productive applications, I love to learn things and I would be happy to improve them!


Handling the hardware back button using Angular is easy, Ionic does all the job by dispatching an event ionBackButton (which bubbles through the document) when the “physical” button is clicked. We just have to listen to that event and then close our modal if something is happening using the ModalController as we would do, if we would manually close the modal.

Angular also provide a handy decorator HostListener which allow us to listen to events without too much code and without thinking about subscribing and unsubscribing.

In short, here’s my Angular code to close Ionic modals using the hardware back button:

import {Component} from '@angular/core'; import {ModalController} from '@ionic/angular'; @Component({ templateUrl: 'my-modal.html', styleUrls: ['./my-modal.scss'], selector: 'app-my-modal' }) export class MyModal { constructor(private modalController: ModalController) {} @HostListener('document:ionBackButton', ['$event']) private async overrideHardwareBackAction($event: any) { await this.modalController.dismiss(); } }


I mostly, for not saying only, use the Ionic PWA toolkit (= StencilJS) to develop, well I guess you already understand, Progressive Web Apps. As I explained in my introduction, the solution using the event ionBackButton won’t work for such applications, therefore I came up with a workaround which consist of pushing a state in the navigation history when the modal is loaded and popping it when the hardware back button is clicked. Not sure if this solution is ugly or not (don’t judge me on this please if it’s the case) but it seems it works well 🤣

In short, here’s my StencilJS code to close Ionic modals using the hardware back button:

import {Component, Element, Listen} from '@stencil/core'; @Component({ tag: 'app-my-modal', styleUrl: 'app-my-modal.scss' }) export class AppMyModal { @Element() el: HTMLElement; async componentDidLoad() { history.pushState({modal: true}, null); } @Listen('window:popstate') async handleHardwareBackbutton(_e: PopStateEvent) { await this.closeModal(); } async closeModal() { await (this.el.closest('ion-modal') as HTMLIonModalElement).dismiss(); } render() { return [ <ion-header> <ion-toolbar> <ion-buttons slot="start"> <ion-button onClick={() => this.closeModal()}> <ion-icon name="close"></ion-icon> </ion-button> </ion-buttons> </ion-toolbar> </ion-header>, <ion-content padding> <h1>Yolo</h1> </ion-content> ]; } }

Stencil One

I didn’t tried yet, but according the BREAKING CHANGES list of Stencil One, listeners will have to be declared a bit differently in the future. If I get it, we will have to convert the above listener decorator to the following declaration:

@Listen('popstate', { target: 'window' })

Cherry on the cake 🍒🎂

Guess what, it works exactly the same with popovers 😉

To infinity and beyond 🚀



Read the article

StencilJS & Web Worker: A Fairy Tale

November 19th 2020

#stencil #showdev #javascript #typescript

Read the article

App Store & Google Play: Submission Checklist

November 3rd 2020

#appstore #googleplay #ios #android

Read the article

Recursively Clean Firestore FieldValue.delete()

October 15th 2020

#firebase #javascript #webdev #firestore

More articles


Fluster GmbH c/o The Hub Zürich Association Sihlquai 131 8005 Zürich

On the web

This website is open source. Its code is available on GitHub