Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1) E52774-01 |
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>
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. |
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". |