Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.1.2) E23188-01 |
The insertTextBehavior tag is a declarative way to have a command component (e.g. a button) insert some text into an input component when clicked. This tag will be ignored for any server-rendered components, as it is only supported for the rich client.
The insertTextBehavior tag cancels server-side event delivery automatically - so actionListener or action attributes on the parent component will be ignored. This cannot be disabled. Developers that need to also trigger server-side functionality can add an additional client listener that uses AdfCustomEvent and af:serverListener to deliver a server-side event.
Note: If EL is used in the EL supported attributes of this tag, this tag will not be stampable.
</section> <section name="Code_Example_s_">This example will insert "hello world" in place of the selection in the inputText with the id "someInput" when the button is clicked.
<af:commandToolbarButton text="Insert text at Selection">
<af:insertTextBehavior for="someInput" value="hello world"/>
</af:commandToolbarButton>
Name | Type | Supports EL? | Description |
---|---|---|---|
for | String | yes | The ID of the input component to which the insertion will be performed. An ID beginning with a colon will be treated as absolute (after trimming off the colon). All other ids will be resolved relative to the component which contains the input. |
value | String | yes | The String representing the text that will be inserted at the current cursor position or selection when invoked. |
triggerType | String | no | the event type which will trigger the text to be inserted. By default, this is "action". |