Using modal dialogs in is fairly common. Whether you want to edit a record in a table without navigating to a different page, look up some data, or just show a warning message to your users, using a modal dialog may be a great user experience. Unfortunately, doing that is not very easy in without a third-party library. It requires writing some non-trivial code and understanding of the internal mechanisms of the Angular framework. That is the reason why we developed a library at Developer Partners for showing modal dialogs in Angular. We are going to use our library in this article. web applications Angular 1. Install the Library We will have to install our library via NPM and include that in our Angular modules to be able to use it. Here is the NPM command to install it: @developer-partners/ngx-modal-dialo g npm install @developer-partners/ngx-modal-dialog Next, we have to include it in the Angular modules where we have to use modal dialogs. Our demo application is very small, it has only one module called AppModule. We have to include ModalModule from the library in the imports array of our AppModule Angular module: We are all set. We can start using the modal dialog component in our application. 2. Show a Modal Dialog As mentioned before, we are going to show our modal dialog when we want to add or edit a book in our list of books. Let's first create a component where we are going to show the list of books. We are going to create a new Angular component and call it . BookListComponent This is the content of the Typescript class: BookListComponent Our class uses a hardcoded list of books as the data to show in our table for simplicity. It also needs the Angular service from the ngx-modal-dialog library to be able to show the modal dialogs that is why we injected it into our constructor. BookListComponent ModalService Next, we will create the HTML file for where we will show the list of books in an HTML table: BookListComponent The HTML code above is pretty simple. It show the list of books in a table. It also has a button called "Add New Book". This is what the UI looks like so far: When the "Add New Book" button is clicked, it calls the function in our Typescript class. The function shows the modal dialog for adding a new book to our table. This is the Typescript code of the function: createBook createBook createBook The function shows the modal dialog by calling the function of the class. The function takes 2 parameters: the class of the Angular component to show inside the modal dialog and the options of modal dialog which are the settings of the dialog such as the title, size, position, and a few other things. The modal dialog needs an Angular component to show in its body. Without that component, our modal dialog would be just an empty panel overlaying the screen. That component is which is the first parameter of the function in the screenshot above. createBook show ModalService show CreateEditBookComponent show The Angular component is going to be responsible for both adding and editing books. We will start by working on the code for adding new books. Here is the HTML code of the CreateEditBookComponent which has only a few fields for entering the ID and title of the book we want to create and has buttons for closing the dialog and saving the data: CreateEditBookComponent This is what the modal dialog UI looks like: Here is the Typescript code of the CreateEditBookComponent component: The component uses an Angular service called from the library. We use that service for interacting with the modal dialog where our component is placed such as closing the modal or subscribing to its events. We simply close the modal dialog in the function in the screenshot above. We call the function when the "Cancel" button from HTML is clicked. When we click the "Save" button in the HTML code, it submits the form which calls the function. In the function, we close the modal dialog just like in the function but we also pass the property to it that contains the data for adding a new book to our list. CreateEditBookComponent ModalReference ngx-modal-dialog cancel cancel saveData saveData cancel book The service is a generic type. When we call the function of the service, we have to pass an object of the same type as its generic parameter. In our case, it's a Typescript interface called . The parameter that we pass to the function is passed back to the component that created the modal dialog by calling the function of the class. ModalReference closeSuccess ModalReference Book closeSuccess show ModalService When the call the closeSuccess function of the ModalReference service, it closes the modal dialog and triggers an RxJS event passing the newly create book to the subscribers of that event. In the screenshot above, the parameter of our callback function is the newly created book that we received from the modal dialog, so we simply add it to our array to show it in the UI. newBook books 3. Passing Data to Modal Dialogs There are some cases where you need to pass some data to modal dialogs. For example, if we want to edit a book from the list, we can pass the book record that we want to edit to the modal dialog to have the initial data that we want to modify. Let's start by adding a button to the table rows for editing the row data: This is what the UI looks like with the Edit button in each row of the table: The function has almost the same code as the function with just one important difference. It passes the book that we want to edit to the modal dialog by using the property of the of the dialog options. editBook createBook model The parameter that we pass to the modal dialog using the property becomes available in the service in the component used inside the dialog via its property. model ModalReference config.model In the screenshot above, we are copying the passed parameter and assigning it to the property of the component. The property of object is passed by reference, so any changes we make in the properties of that object will be reflected in the table where we show the list of books. The reason why we copy it is to not modify the row in the table until the user clicks the "Save" button. If the user clicks the "Cancel" button, the table data will not be updated. book CreateEditBookComponent model ModalReference.config This is what the Edit Book modal dialog looks like: Conclusion Building a modal dialog for Angular from scratch is not easy, but it is much easier with our modal dialog library. We went through how to set up the library and use it for showing modal dialogs in your project. We went through most basic use cases and features of the dialogs, but the @developer-partners/ngx-modal-dialog library has a lot of other features that you may find useful in your real projects. Also published here. Please follow the link below to learn more about it: @developer-partners/ngx-modal-dialog In case if you would like to show a nice loading spinner in your modal dialogs, please see our article about building a loading spinner in Angular: How to Create a Loading Spinner in Angular

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

This writer has a vested interest be it monetary, business, or otherwise, with 1 or more of the products or companies mentioned within.

Learn More

Too Long; Didn't Read

Make resilience your competitive advantage

How to Show a Modal Dialog in Angular

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

10 Useful JavaScript Functions to Learn

10 Cool Angular Material Admin Dashboard Templates

13 Angular App Optimization Tips for Frontend Developers

25 Stories To Learn About Angularjs

16 JavaScript Protips [2020 Edition]

10 Useful JavaScript Functions to Learn

10 Cool Angular Material Admin Dashboard Templates

13 Angular App Optimization Tips for Frontend Developers

25 Stories To Learn About Angularjs

16 JavaScript Protips [2020 Edition]

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps