Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 11g Release 1 (11.1.1.7.0) E12419-09 |
The richTextEditorInsertBehavior tag is a declarative way to have a command component (e.g. a button) insert some rich text into a richTextEditor when clicked. This tag will be ignored for any server-rendered components, as it is only supported for the rich client.
The richTextEditorInsertBehavior 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.
This example will insert "hello world" in place of the selection in the richTextEditor with the id "someInput" when the button is clicked.
<af:commandToolbarButton text="Insert Fragment at Selection">
<af:richTextEditorInsertBehavior for="someInput" value="hello world"/>
</af:commandToolbarButton>
Name | Type | Supports EL? | Description |
---|---|---|---|
for | String | yes | the ID of the richTextEditor 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 richTextEditorInsertBehavior. |
value | String | yes | the XHTML fragment String representing the rich text that will be inserted at the current cursor position or selection when invoked |