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.
<source> <af:commandToolbarButton text="Insert Fragment at Selection"> <af:richTextEditorInsertBehavior for="someInput" value="hello world"/> </af:commandToolbarButton>
|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|