Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-02 |
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.
Note: If EL is used in the EL supported attributes of this tag, this tag will not be stampable.
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>
Attributes
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