ICE Components
Tag panelPositioned


With the positioned panel component lists can be used to generate a series of repeating child-components within a panel. Each one of these child-components is draggable and can exchange positions with other children in the same panel as well as a child component can be moved between different positioned panels components. When a Child Component is moved the source value (java.util.List/Array ) for the positioned Panel is modified by the component to reflect the new order of the positioned panel.
(e.g.)
<ice:panelPositioned var="person"
value="#{panelPositioned.people}" >
<ice:panelGroup style="cursor:move;">
<ice:outputText value="#{person.name}"/>
</ice:panelGroup>
</ice:panelPositioned>


Tag Information
Tag Classcom.icesoft.faces.component.panelpositioned.PanelPositionedTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
beforeChangedListenerfalsefalsejava.lang.StringbeforeChangedListener called before the list is changed. Which takes a PanelPositionedEvent. User can cancel event by calling cancel() on PanelPositionedEvent. If cancel() was called then the list will not be changed and the listener will not be called. (e.g.)
public void methodName(PanelPositionedEvent event);
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean
constraintfalsefalsejava.lang.String

The following are the valid values for this attribute. This attribute has an impact on the presentation of the positioned element while dragging.

  • horizontal:
    While dragging an item horizontally outside from the positioned panel. The draggable element can be seen moving outside, whereas with the "vertical" you can drag an element outside but the draggable elemement doesn't go out of its container.
  • vertical:
    While dragging an item vertically, the item underneath it moves up or down smoothly with slide effect and makes an empty space for the draggaed item, whereas in horizontal mode you don't see the slide effect
  • false:
    You can drag the positioned element vertically or horizontally but you don't see any slide effect as well as the draggable element doesn't go outside of its panel.
disabledfalsefalsejava.lang.StringFlag indicating that this element must never receive focus or be included in a subsequent submit.
enabledOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, the component will be in disabled state.
firstfalsefalsejava.lang.StringNote: This is deprecated.
handlefalsefalsejava.lang.StringThe css class of a child node that is used to drag the item. (e.g.)
<ice:panelPositioned var="person"
value="#{panelPositioned.people}" handle="personClass" >
<ice:panelGroup >
<ice:outputText style="cursor:move;" styleClass="personClass" value="drag #{person.name}"/>
<ice:outputText value="this panel can only be dragged by the person name."/>
</ice:panelGroup>
</ice:panelPositioned>
hoverclassfalsefalsejava.lang.StringNote: This is deprecated.
idfalsefalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
listenerfalsefalsejava.lang.StringListener, called when list is changed. Which takes a PanelPositionedEvent. (e.g.)
public void methodName(PanelPositionedEvent event);
overlapfalsefalsejava.lang.StringNote: This is deprecated.
renderedfalsefalsejava.lang.StringFlag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
rowsfalsefalsejava.lang.StringNote: This is deprecated.
stylefalsefalsejava.lang.StringCSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.String

Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
The default class would be rendered as icePnlPos

valuefalsefalsejava.lang.StringThe data model for this component. Could be a java.util.List or an Array
varfalsefalsejava.lang.StringName of a request-scope attribute under which the model data presented for the current row.
varStatusfalsefalsejava.lang.String

Name of a request-scope attribute under which the current indexed state will be exposed. This is modeled after the Facelets JSTL c:forEach varStatus. The varStatus object has 5 sub-properties:

int begin
Corresponds to the UIData container's first property, the index at which it begins iteration.
int end
The ending index of iteration, corresponding to the UIData container's first plus rows minus 1. Note: If the UIData's DataModel's isRowAvailable() method returns false, prematurely ending iteration, then the actual ending index may not equal the value for this end property.
int index
The current iteration index. Corresponding to the UIData container's getRowIndex() value, which also corresponds with the UIData's DataModel's getRowIndex() value.
boolean first
Defined simply as: varStatus.index == varStatus.begin
boolean last
Defined simply as: varStatus.index == varStatus.end. Note: This has the same limitations as the end property.

Variables
No Variables Defined.


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.