Oracle Fusion Middleware Tag Reference for Oracle ADF Faces
12c (12.1.3)

E41657-01

<af:checkRegionUncommittedDataBehavior>

checkRegionUncommittedDataBehavior check region uncommitted data behavior


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.

</section> <section name="Code_Example_s_">

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 Type Component Family Description
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".