Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-03

# <af:richTextEditorInsertBehavior>

richTextEditorInsertBehavior richtexteditorinsertbehavior

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