Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces-EE ACE Components
Tag dialog

The Dialog is a container component that can overlay other elements on page. Dialog has several customization options such as modal, resize, width, height, position. If position of dialog is out of place, try putting it as last child of body.

For more information, see the Dialog Wiki Documentation.

Client Events
Name | Description | Supported classes for argument
close | Fired when the panel is closed (default event). | org.icefaces.ace.event.CloseEvent

Client events can be used with Client Behaviors and the ace:ajax tag.

Tag Information
Tag Class | org.icefaces.ace.component.dialog.DialogTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
binding | no | true | `javax.el.ValueExpression` | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
closable | no | true | `boolean` | Boolean value that specifies whether the dialog should have a close button in the header. Default = 'true'.
closeOnEscape | no | true | `boolean` | Boolean value that Specifies whether the dialog should close when it has focus and the user presses the escape (ESC) key. Default = 'true'.
dialogPosition | no | true | `java.lang.String` | The side of the dialog to position in relation to the target component. The format is " ". Possible horizontal values are "left", "right" and "center". Possible vertical values are "top", "center", and "bottom". Example: "left top" or "center center". Default = 'center'.
draggable | no | true | `boolean` | Boolean value whether to allow the user to drag the Panel using its header Default = 'true'.
header | no | true | `java.lang.String` | Header text
height | no | true | `int` | Height of the element in pixels. Default (not specified or value <= 0) is auto. If auto, resizable should be false, or resizing may hehave erratically. If auto, IE7 may not size or position properly. Default = 'Integer.MIN_VALUE'.
hideEffect | no | true | `java.lang.String` | Effect to use when hiding the dialog. Possible values are 'blind', 'clip', 'drop', 'explode, 'fade', 'fold', 'puff', 'slide', 'scale', 'bounce', 'highlight', and 'shake' (Some effects are not supported in IE browsers, see wiki page for more information).
id | no | true | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
minHeight | no | true | `int` | Minimum height of resizable dialog Default = '0'.
minWidth | no | true | `int` | Minimum width of a resizable dialog Default = '150'.
modal | no | true | `boolean` | Boolean value that specifies whether the document should be shielded with a partially transparent mask to require the user to close the Panel before being able to activate any elements in the document Default = 'false'.
onHide | no | true | `java.lang.String` | Javascript code to be executed when hiding the dialog
onShow | no | true | `java.lang.String` | Javascript code to be executed when showing the dialog
position | no | true | `java.lang.String` | Specifies where the dialog should be displayed relative to the viewport. Possible values: 1) a single string representing position within viewport: 'center', 'left', 'right', 'top', 'bottom'. 2) an array containing an x,y coordinate pair in pixel offset from left, top corner of viewport (e.g. [350,100]) 3) an array containing x,y position string values (e.g. ['right','top'] for top right corner).
relativePosition | no | true | `java.lang.String` | The side of the target component to position the dialog against. The format is " ". Possible horizontal values are "left", "right" and "center". Possible vertical values are "top", "center", and "bottom". Example: "left top" or "center center". Default = 'center'.
relativeTo | no | true | `java.lang.String` | Id of the component to position the dialog against. Setting this id will override the 'position' attribute, using 'dialogPosition' and 'relativePosition' instead.
rendered | no | true | `boolean` | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
resizable | no | true | `boolean` | Makes the dialog resizable. Should be false if width or height is auto, or resizing may hehave erratically. Default = 'true'.
setFocus | no | true | `java.lang.String` | Specifies the ID of the component contained within the dialog that should receive focus when the dialog is made visible. Note that this feature does not work with ACE components in this release (h: and ice: are supported).
showEffect | no | true | `java.lang.String` | Effect to use when showing the dialog. Possible values are 'blind', 'clip', 'drop', 'explode, 'fade', 'fold', 'puff', 'slide', 'scale', 'bounce', 'highlight', 'pulsate', and 'shake' (Some effects are not supported in IE7, see wiki page for more information).
showHeader | no | true | `boolean` | Boolean value that specifies whether the dialog should have a header (default true) Default = 'true'.
styleClass | no | true | `java.lang.String` | Style class of the main container of dialog
visible | no | true | `boolean` | visible can be used to toggle visibility on the server, rendered should not be used that way, setting rendered=false on a visible modal dialog will not remove the modality layer, visible=false must be set first (or client-side JS function called) Default = 'false'.
widgetVar | no | true | `java.lang.String` | Name of the widget to access client side api
width | no | true | `int` | Width of the element in pixels. Default (not specified or value <= 0) is auto. If auto, resizable should be false, or resizing may hehave erratically. If auto, IE7 may not size or position properly. Default = 'Integer.MIN_VALUE'.
zindex | no | true | `int` | zindex property to control overlapping with other elements Default = '1000'.

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.