Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-02 |
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 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".