Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces EE Composite Components
Tag dialog

## The Dynamic Dialog Composite Component

A popup dialog that can be used for the whole application

### Features

- Choose between rendering okay/yes/no/cancel buttons.
- Programatically create and pass in Commands for these buttons.
- Choose dialog content with a Facelet include.

### How To Use

1. Add the ice-cc:dialog tag to your application in a spot where it is not nested in a form
2. Create a class extending DialogTypes and register it as a reqest scope bean named 'dialogTypes' in faces-config.xml
3. Add at least one dialog in the constructor and a call to setDefaultDialog()
4. To launch the dialog obtain a reference to the managed-bean named 'dialogState', retrieve the current Dialog, configure and set the Dialog to render

Example:

    <ice-cc:dialog modal="true" dialog="#{dialogState.currentDialog}" styleClass="#{dialogState.currentDialog.cssStyle}"/>

Tag Information
Tag Class | javax.faces.webapp.FacetTag
TagExtraInfo Class | None
Body Content | tagdependent
Display Name | Dialog Popup Component

Attributes
Name | Required | Request-time | Type | Description
dialog | true | false | `com.icesoft.faces.facelets.component.dialog.Dialog` | Must resolve to an instance of the Dialog class
autoCentre | false | false | `java.lang.Boolean` | Used to keep the popup centred on the screen through scrolling and window resizing events.
autoPosition | false | false | `java.lang.String` | Used to keep the popup positioned on the screen through scrolling events. Use a string of x and y px values (e.g. autoPostion="35,200"). For a modal popup, use "manual" to disable automatic centering on the document. Then specify top, left positions by style or styleClass.
draggable | false | false | `java.lang.Boolean` | When set to 'true' this component is draggable. The user will be able to drag the panel to any position on the page. Note: all Draggable panels must be contained in a form.
clientOnly | false | false | `java.lang.Boolean` | Sends update to the server on drop event if false. Default value is false.
positionOnLoadOnly | false | false | `java.lang.Boolean` | Centre or position popup once on load only. Any drag and drop will disable autoCentre and autoPosition.
modal | false | false | `java.lang.Boolean` | Sets the popup to be modal (default false)
title | false | false | `java.lang.String` | The title header for the popup
effect | false | false | `com.icesoft.faces.context.effects.Effect` | The Javascript Effect
okButtonStyleClass | false | false | `java.lang.String` | Passed through to styleClass attribute of 'ok' ice:commandButton component
yesButtonStyleClass | false | false | `java.lang.String` | Passed through to styleClass attribute of 'yes' ice:commandButton component
noButtonStyleClass | false | false | `java.lang.String` | Passed through to styleClass attribute of 'no' ice:commandButton component
cancelButtonStyleClass | false | false | `java.lang.String` | Passed through to styleClass attribute of 'cancel' ice:commandButton component
styleClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) to be applied when this element is rendered.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.