RichFaces 4 inplaces components

    Overview

    This document will describe the migration of inplaceInput and inplaceSelect components.

    information from 3.3.x:

     

    references:

    http://docs.jboss.org/richfaces/latest_3_3_X/en/devguide/html/rich_inplaceInput.html

    http://docs.jboss.org/richfaces/latest_3_3_X/en/devguide/html/rich_inplaceSelect.html

     

    tld:

    http://docs.jboss.org/richfaces/latest_3_3_X/en/tlddoc/rich/inplaceInput.html

    http://docs.jboss.org/richfaces/latest_3_3_X/en/tlddoc/rich/inplaceSelect.html

     

    svn

     

    http://anonsvn.jboss.org/repos/richfaces/branches/community/3.3.X/ui/inplaceInput

    http://anonsvn.jboss.org/repos/richfaces/branches/community/3.3.X/ui/inplaceSelect

     

    Related requests and jiras

    http://tinyurl.com/26y6bg4

     

    Common info and requirements

    At first both component - does not require complete functional redesign - so the goal of the document - to highlight changes to be made during migration.

     

    Buttons requirements change

    Both components provides buttons for closure (saven and cancel)

    That buttons in 3.3.3 if shown - was prevents the inplaces to be closed after blur. In 4.x - it should not occurs. If the component focused - edit state should be activated and immediatelly deactivated after blur. The value changing behavior for that automatical closure described in "Switching from edit state to view/changed state" section.

    inplaces in scrollable containers

    scrolling any container (probably except browser window if possible) should cause the inplace automatically to be deactivated in order to prevents the positioning problem in IE. The value changing behavior for that automatical closure described in "Switching from edit state to view/changed state" section.

     

    In future we could add the attribute to turn it off by request.

    Switching from edit state to view/changed state

    Not implemented in M2 - https://jira.jboss.org/browse/RF-9347. Currently the component works already saving the value on such loosing focus.

    Nothing should be changed from 3.3.x(handling Enter and ESC - should remains as it was before) except next point:

     

    switching to view/changed state if the component just looses focus(or closed automatically) should be configurable. saveOnBlur boolean attribute should be added and has false value by default.  So if the user activate the control and make some changes and just bluring the component it should:

    • store new value and show changed state if the attribute has true value
    • do no store changes and be switched to view state with previous value if attribute has false value.
    Disabled State

    https://jira.jboss.org/browse/RF-9348 - not implemented for now.

    Need to add disable state to both components. In disabled states - them should just be rendered as outputText with current value. Also default label should be ignored in that case.

    Inplace Input Specific

    attributes changes

    TBD

    Inplace Select Specific

    SelectItems disabling and grouping

    both features should be supported.  Postponed to after-M3

    attributes changes

    TBD

     

    Not implemented in M4

    • disabled state
    • onchange, viewchange events