<toolbarButtonGroup> Element

This element will cause a particular group of buttons to be present on the toolbar within Ephox EditLive! for Java.  The buttons added by this element can only be added and removed from the toolbar as a group.

The operation of these buttons within EditLive! for Java will be mutually exclusive.  For example, the alignment buttons are a button group as Align Left cannot be activated at the same time as Align Right.

Element Tree Structure

<editLiveForJava>
    <toolbars>
        <formatToolbar> OR <commandToolbar>
            <toolbarButtonGroup>

<editLiveForJava>
     ...
     <toolbars>
          <formatToolbar> OR <commandToolbar>*
               <toolbarButtonGroup ... />
          </formatToolbar> OR </commandToolbar>*
     </toolbars>
     ...
</editLiveForJava>

*Note:  The <toolbarButtonGroup> element can exist within either the <formatToolbar> element or the <commandToolbar> element.  Closing tags should be matched to opening tags (ie. <formatToolbar> ... </formatToolbar>).

Required Attributes

Attribute Description
name This attribute gives the name for the button group.  It must be one of the following:
  • tlbAlign - The Align Left, Align Center and Align Right buttons.
  • tlbList - The Ordered List and Unordered List buttons.
  • tlbScript - The Subscript and Superscript buttons.

Example

The following example demonstrates how to add the alignment buttons to the Format Toolbar.

<editLiveForJava>
    ...
    <toolbars>
        <formatToolbar>
            <toolbarButtonGroup name="tlbAlign" />
        </formatToolbar>
    </toolbars>
    ...
</editLiveForJava>

Remarks

The <toolbarButtonGroup> element can appear multiple times within the <formatToolbar> or <commandToolbar> elements.

The <toolbarButtonGroup> element must be a complete tag, it cannot contain a tag body.  Therefore the tag must be closed in the same line.  See the example below:

    <toolbarButtonGroup name=... />

See Also