Getting POPUP in Liferay application

Using Pop-up in Liferay

Tags: development liferay 5.1 liferay 5.2 liferay popup pop up pop-up

When developing portlets in Liferay there are two ways to implement pop-ups. We can use a Floating Div or the traditional new browser Window without the toolbars. Each of them has got their advantages so we will have to decide which one fits us better. For example, if you are using a pop up with a form, you won't be able to send files attached to the form if you are using a floating div.

In this article there are some tips to develop both types of pop-ups.

Floating Div Pop-Up

Liferay provides a class called Expanse.Popup to implement this type of pop ups. Here is how this type of pop up would look like:

One advantage of this type of pop up is that they are invisible to pop up blockers (although that could change as they get smarter). This javascript code will make an asynchronous call to the url we give it and will place the content in our page. Below there is an example which will load the url 'url' in a pop up called 'our title':

var popup = new Expanse.Popup(
    {
     header: 'our title',
     position:[150,150],
     modal:true,
     width:500,
     height:300,
     xy: ['center', 100],
     url: 'url',
     urlData: {
      parameter1: 'value1',
                                            parameter2: 'value2'
     }
    }
   );

It's important to note that if the url is a portlet url it must have the windowState parameter set to LiferayWindowstate.EXCLUSIVE, because we just want the content produced by the portlet and not the extra portlet decoration produced by the portal.

To implement a button or link to close the pop up use the following code:

Expanse.Popup.close(this);

This type of pop-up is used in several Liferay core portlets like the image gallery (show pictures), journal (edit template) or my communities (publish to live). Look at them for further examples of usage.

Window Pop up

This type of pop ups will load in a new window. In order to do that we must set the windowState parameter in the portlet url to LiferayWindowState.POP_UP. This windowState will produce that the result of calling a portlet url will be shown in another window, like a real pop up. There are no visual effects asociated, it's a different window.

However, from this window we can still make javascript calls to the parent page javascript functions as the javascript object opener refers to the parent window. There is an example below:

--lt--input value="select" onclick="  var organizationWindow = window.open('    <%= LiferayWindowState.POP_UP.toString() %>">
    
     
   ',
    'title',
   'directories=no, height=640, location=no, menubar=no, resizable=yes,
                                                                           scrollbars=yes, status=no, toolbar=no, width=680');
 
 organizationWindow.focus();" / --gt--

If we want to close the pop up we just need to do the following:

 window.close(); 

If we want to close the parent page we can do the following:

opener.close(); 

This is used in several portlets like the image gallery (show slideShow), enterprse admin (select organizations for users...)