RichFaces Migration Guide. 3.3.x - 4.x Migration - Components migration - Rich Panel/Output Components

Version 5
    IMPORTANTThat document is under continous development. It's published in order you to have the fastest access to all the new info posted there even considering that document itself will be extended more in the same time. So please be patient, and do not forget leave your feedback and requests for additional information at RichFaces Space Forum. We could do it really great together!

    Only component high-level changes and component-specific functionality removal/changes mentioned there. For common attributes names changes follow the [Rich components standartized attributes| link ]

     

    RichFaces 3.3.3RichFaces 4.xChanges
    modalPanelpopupPanel

    Most noticeable - added with non-modal state. Other functionality kept.

    • showWhenRendered attribute renaimed to just show. should be same boolean expression.
    • ability of dynamic parameters changing from JS show() calls. [demo]
    paint2Dremoved
    and not going to be implemented in near time without requests and discussions. JSF 2 provides dynamic resources for that.
    panelpanel
    not changed.

    panelBar

    panelBarItem

    accordion/accordionItem

    Added with server and ajax mode. In those modes fires server event(ItemChangeEvent) and provides listener(itemChangeListener attribute). Provides icons set for headers and set of customization attributes. Added with switching JS API.

    Panel Should be wrapped with form in server and ajax mode!

    [reference]

    panelMenu

    panelMenuGroup panelMenuItem

    panelMenu

    panelMenuGroup

    panelMenuItem

    Added with additional event for current selection change(ItemChangeEvent) and listener attribute(itemchangeListener at panelMenu) instead of ValueChangeListner.

    Added with bubling selection feature.

    Allows to send actions either for items selection or for groups selection.

    Added with switching/selections JS API.

    Menu Should be wrapped with form in server and ajax mode!

    Demos moved from panels to menus group.

    Reference

    progressBarprogressBarnot changed.
    separatorremovedand not going to be there as has no server side functionality so could be replaced just with <hr/> with needed styles in markups. (or use composite component)
    simpleTogglePanelcollapsiblePanel

    Added with header icons. actionEvent changed to custom  PanelToggleEvent. Added with switching JS API.

    opened attribute which allows to manage state renaimed to expanded

    spacerremovedand not going to be implemented because spacer.gif usafe does not satisfies the semantic markups principles. use composite component with custom spacer.gif image if need.
    tabPanel/tabtabPanel/tab

    replaced ValueChangeEvent and valueChangeListener attribute with custom ItemChangeEvent event and corresponding itemChangeListener attribute.

    Added with switching JS API.

    Panel should be wrapped with formin server and ajax mode!

    label atrtributes for tab renaimed to header and now the same as facet name.

    [reference]

    togglePanel

    facets

    toggleControl

    togglePanel

    togglePanelItem

    toggleControl

    replaced ValueChangeEvent and valueChangeListener attribute with custom ItemChangeEvent and corresponding itemChangeListener attribute.

    Added with switching JS API.

    Notice that new togglePanelItem component should be used instead of facets.  So switch ordering attributes removed and just order of definition used on cycled switching. Also some attributes moved/duplicated at item level.

    Notice that toggleControl changed from component (link) to behavior. So could be attached to any component to be used for switching.

    Panel Should be wrapped with formin server and ajax mode!

    [reference]

    toolBar/toolBarGrouptoolbar/toolbarGroupNotice name change! Not chaged functionaly.
    toolTiptooltip

    Notice name change!

    Not chaged functionaly.