Oracle Fusion Middleware Tag Reference for Oracle ADF Faces
11g Release 2 (11.1.2.0.0)

E17491-02

<af:richTextEditorInsertBehavior>

richTextEditorInsertBehavior rich text editor insert behavior


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.

</section> <section name="Code_Example_s_">

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