<toolbarButtonGroup> Element
Prev Chapter 18. XML Configuration API Next

<toolbarButtonGroup> Element

This element will cause a particular group of buttons to be present on the toolbar within Ephox EditLive! for XML. 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 XML 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

<editLive>
     ...
     <toolbars>
          <toolbar>
               <toolbarButtonGroup ... />
          </toolbar>
     </toolbars>
     ...
</editLive>

Required Attributes

name

This attribute gives the name for the button group. The Menu Item and Toolbar Button Groups section of the Customizing the EditLive! for XML Interface guide contains a list of available groups and the associated name attribute.

Example

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

<editLive>
    ...
    <toolbars>
        <toolbar name="format">
            <toolbarButtonGroup name="Align" />
        </toolbar>
    </toolbars>
    ...
</editLive>

Remarks

The <toolbarButtonGroup> element can appear multiple times within the <toolbar> 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=... />

Copyright 2001-2004 Ephox Corporation. All Rights Reserved.

Prev Up Next
<toolbar> Configuration Element Home <toolbarSeparator> Configuration Element