Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-03

# <af:checkRegionUncommittedDataBehavior>

checkRegionUncommittedDataBehavior checkregionuncommitteddatabehavior

Provides a declarative way to show a warning about uncommitted data within the certain region components when the trigger event fires on the client. If the user chooses not to proceed with the action, the client event will be cancelled.

This will show a button called "Close Region". When the button is pressed, uncommitted data warning will be shown if the regions with scoped Ids "r1" or "r2" contain uncommitted data

###

##

      <af:button text="Close Region" immediate="true" action="closeRegion">
          <af:checkRegionUncommittedDataBehavior regionIds="r1 r2"/>
      </af:button>
                Here we have a link with a behvior that will be checking its enclosing region

      <af:commandLink text="Close" immediate="true" action="close">
          <af:checkRegionUncommittedDataBehavior message="Discard Unsaved Data?"/>
      </af:commandLink>

            Client Event Trigger Types
            The following table lists component family-specific event types that can be assigned to the triggerType
            attribute:
                     Event TypeComponent FamilyDescription
              action  Command  Fires when user triggers the command component. Owning component's
                                                         server-side action listeners will be ignored when the user chooses not
                                                         to proceed with the action.
              removeItem  showDetailItem, navigationPane, commandNavigationItem  Fires when user performs
                                                         an action to remove an item, Owning component's server-side action
                                                         listeners will be ignored when the user chooses not to proceed
                                                         with the action.

    Attributes

        Name
        Type
        Supports EL?
        Description

    regionIds
    String[]
    yes

        the IDs of the target regions, relative to the containing component.  An ID beginning
        with a colon will be treated as absolute (after trimming off the colon). When this attribute is omitted,
        this behavior will be checking the component's immediate <af:region> ancestor

    message
    String
    yes

        Optional message that will be shown to the user when the warning is displayed. When this attribute is omitted, the standard
        message will be shown

    triggerType
    String
    no

                   The event type which will trigger the uncommitted data check. By default, this is "action".