Click here to Skip to main content
15,867,568 members
Articles / Web Development / HTML

JavaScript Modal Popup Window

Rate me:
Please Sign up or sign in to vote.
4.84/5 (48 votes)
15 May 2014CPOL3 min read 693.1K   39.4K   55   136
Flexible JavaScript Modal Popup Window
Image 1

Introduction

Nowadays, JavaScript Modal Popup window has become an intrinsic part of Web based application. Lately, I had a requirement where I needed to use Modal Popup Window. I Goggled for it and found many JQuery based Modal Popup Windows, but none of the code was fitting my needs.

So I decided to create my own Modal Popup window without using JQuery which should be easy to use and is flexible.

Using the Code

First, you need include ModalPopupWindow.js file in your web page as given below:

JavaScript
<script src="JavaScript/ModalPopupWindow.js"
type="text/javascript"></script>

Once you have included the JS file, you need to create an instance of ModalPopUpWindow. For that, you need to write the below mentioned code:

JavaScript
modalWin = new CreateModalPopUpObject();

modalWin object provides three functions to create three types of modal windows which are mentioned below:

  • ShowMessage
  • ShowConfirmationMessage
  • ShowURL

ShowMessage

ShowMessage can be used when you want to show some information to the user:

Image 2

JavaScript
ShowMessage(message, height, width, title)

ShowMessage function takes four parameters:

  • Message: Message that you need to display to the user
  • Height: Height of the message window
  • Width: Width of message window
  • Title: Title of the window

Syntax for calling is as follows:

JavaScript
modalWin.ShowMessage('This Modal Popup Window using Javascript',200,400,'User Information');

ShowConfirmationMessage

ShowConfirmationMessage window can be used where you want to take confirmation from user:

Image 3

JavaScript
ShowConfirmationMessage(message, height,
            width, title, onCloseCallBack, firstButtonText, onFirstButtonClick, secondButtonText,
            onSecondButtonClick)

ShowConfirmationMessage function takes eight parameters:

message, height, width, title parameters are already described above.

  • onCloseCallBack (optional): Name of the function that will get called on confirmation window close
  • firstButtonText: Text that needs to be displayed on first button (like Yes, Agree, OK, etc.)
  • onFirstButtonClick: Name of the function that will get called on click of first button.
  • secondButtonText: Text that needs to be displayed on second button (like Yes, Agree, OK, etc.)
  • onSecondButtonClick: Name of the function that will get called on click of second button

Syntax for calling is as given below:

JavaScript
modalWin.ShowConfirmationMessage('This
           Modal Popup Window using Javascript',200,400,'User Confirmation',
           null,'Agree',Action1,'Disagree',Action2);

ShowURL

ShowURL function can be used when you want to display a new page or URL in Modal popup window.

Image 4

JavaScript
ShowURL(url, height, width, title,
           onCloseCallBack, callbackFunctionArray)

height, width, title, onCloseCallBack are already described above.

  • url: Location or URL of the web page
  • callbackFunctionArray (optional): Using this parameter, you can pass array of function of parent page to the child page inside Modal Window. So that child page can access function of parent page.

Syntax for calling is as follows:

JavaScript
var callbackFunctionArray = new Array(EnrollNow,
EnrollLater);

modalWin.ShowURL('Child.htm',320,470,'User
Enrollment',null,callbackFunctionArray);   

SetButtonStyle

You can change the button style using function SetButtonStyle. Sometimes, you may want to show button as link, in that case you can use this function. Below is an example to show buttons as link.

Image 5

JavaScript
SetButtonStyle(btnStyle)
  • btnStyle: is semicolon separated styles for buttons. The naming convention for the styles should be like JavaScript not like CSS style. For example in CSS, we use "text-decoration" and in JavaScript, we use "textDecoration". So, please make sure while passing styles that you are using JavaScript naming convention.

Syntax for calling is as given below:

JavaScript
modalWin.SetButtonStyle("background:none;border:none;textDecoration:underline;cursor:pointer");

Dragging Window

By default ModalPopUpWindow is draggable, for dragging window you need press mouse over window title bar and drag. In case you don’t want window to be draggable, then you can use Draggable property of ModalPopUpWindow. You need to set this property every time just before calling any show function of ModalPopUpWindow to make it un-draggable

Image 6

Syntax for making window un-draggable is given below:

JavaScript
modalWin.Draggable=false;
modalWin.ShowMessage('You can not drag this window',200,400,'User Information');

Passing Values From Modal Popup Child Window To Parent Window

Sometimes, we may need to pass values from child modal window to parent window while using "ShowURL" function of modal window. In JavaScript, we can use window.parent for accessing parent window elements/functions. So we can use the same (window.parent) for passing value from child popup window to parent window. You can find example of the same in the attached demo code where clicking on "Show URL Window" will show up popup window and when you will click on "Enroll Now" button, it will pass values of child window to parent window as shown in below screenshots:

Image 7

Image 8

Summary

In the attached source code, you will find examples for all the scenarios described in this tip. Apart from that, you can modify the source code depending on your requirement.

History

  • Updated source code version v4 for supporting IE11 on 20-Nov-2013

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer (Senior)
India India
Developer

Comments and Discussions

 
Questionclose the modal by clicking anywhere except the modal Pin
Mostafa Zahedi18-Apr-23 1:04
Mostafa Zahedi18-Apr-23 1:04 
QuestionPassing Parent Variables to the Popup Window Pin
tcyrus10-Dec-18 5:57
tcyrus10-Dec-18 5:57 
QuestionThank you Pin
Member 1392957328-Jul-18 21:06
Member 1392957328-Jul-18 21:06 
QuestionUnable to call modal popup box on a script Pin
Member 1259762122-Jun-16 0:08
Member 1259762122-Jun-16 0:08 
QuestionUse modal window from NavBar link Pin
Member 1239772820-Mar-16 17:07
Member 1239772820-Mar-16 17:07 
GeneralMy vote of 5 Pin
willichan7-Nov-15 9:23
professionalwillichan7-Nov-15 9:23 
QuestionTitle bar color Pin
Member 83846644-Nov-15 8:57
Member 83846644-Nov-15 8:57 
AnswerRe: Title bar color Pin
Carsten V2.027-Dec-15 1:10
Carsten V2.027-Dec-15 1:10 
GeneralRe: Title bar color Pin
King642-Nov-17 21:31
King642-Nov-17 21:31 
QuestionHelp to use your code with another. Pin
jasancorts8-Oct-15 19:09
jasancorts8-Oct-15 19:09 
GeneralThanks a lot. You save my day. Pin
Jennie Lay25-Sep-15 1:03
Jennie Lay25-Sep-15 1:03 
QuestionPosition the modal Pin
Wombaticus20-Sep-15 4:41
Wombaticus20-Sep-15 4:41 
Question0x800a1391 - JavaScript runtime error: 'bailwal_modalPopupWindow' is undefined Pin
Pong God18-Sep-15 6:34
Pong God18-Sep-15 6:34 
Just trying this for the first time and got this error message when I execute the following statement:

JavaScript
modalWin = new CreateModalPopUpObject();


Please advise.
AnswerRe: 0x800a1391 - JavaScript runtime error: 'bailwal_modalPopupWindow' is undefined Pin
Pong God18-Sep-15 12:31
Pong God18-Sep-15 12:31 
Questionparent variable Pin
Member 1151064730-Mar-15 21:06
Member 1151064730-Mar-15 21:06 
QuestionModal Popup Window returns to top of page Pin
Member 114898183-Mar-15 21:42
Member 114898183-Mar-15 21:42 
QuestionRegarding MOdal popup Pin
Member 110211898-Feb-15 23:26
Member 110211898-Feb-15 23:26 
QuestionIs there away to detect if the modal is finished loading? Pin
Member 947787826-Jan-15 5:35
professionalMember 947787826-Jan-15 5:35 
QuestionHow to position the pop up window Pin
Member 1112994115-Jan-15 18:31
Member 1112994115-Jan-15 18:31 
GeneralThanks I love what you have done. Pin
Member 1136943814-Jan-15 1:20
Member 1136943814-Jan-15 1:20 
QuestionResponssive design implementation. Pin
Member 1101171731-Dec-14 3:56
Member 1101171731-Dec-14 3:56 
AnswerRe: Responssive design implementation. Pin
Mahesh Bailwal9-Jan-15 19:03
Mahesh Bailwal9-Jan-15 19:03 
QuestionValues not populating in google chrome Pin
Member 1118598528-Oct-14 0:24
Member 1118598528-Oct-14 0:24 
AnswerRe: Values not populating in google chrome Pin
Member 1118364628-Oct-14 0:29
Member 1118364628-Oct-14 0:29 
GeneralRe: Values not populating in google chrome Pin
Member 1118598528-Oct-14 1:05
Member 1118598528-Oct-14 1:05 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.