During the component showcase refactoring I had a change to use the panelPositioned component for the first time. Unfortunately the component has some issue that will make the average user pretty unhappy. Here are the issues in no particular order.

Simple/picky Issues
- Documentation is very poor, end user has to make many assumption and read between the lines to figure out how the component works.
- Component only takes list interface as a value. I find this strange as just about every other JSF component that iterates can also take arrays.

Functionality Issues
- positioning a component will not work unless the listener class has been hocked up in a the backing bean. Also the listener uses a customer listener/event object which is not documented. End user has to guess what the signature of the method.
- constraint attribute can take either vertical or horizontal and possibly no value. There is very little documentation around how this attribute would be used for a horizontal and vertical instance of the component.
- the whole component is dragable and as a result text selection is not possible for any contained content.
- specifying a handle attribute breaks the component. No positioning is possible once specified.
- the style attributes hoverClass and overlap appear to be broken as the style do not get applied as specified by the documentation.
- And lastly there is no security attributes for render and disable on user role.