<customToolbarComboBox> Configuration Element

This element specifies the properties for a developer defined custom toolbar combo box for use within Ephox EditLive! for XML.

Configuration Element Tree Structure

<editLive>
     ...
     <toolbars>
          <toolbar>
               <customToolbarComboBox>
                    <!--custom toolbar combo box settings-->
               </customToolbarComboBox>
          </toolbar>
     </toolbars>
     ...
</editLive>

Required Attributes

name

The name which uniquely defines this custom toolbar combo box.

Optional Attributes

xhtmlonly

This attribute defines whether the custom toolbar combo box should be active only when the cursor is placed within an XHTML section. Setting this attribute to true will ensure that the toolbar combo box is only active when the cursor is within an XHTML section.

Default: false

Child Elements

<customComboBoxItem>

This element defines an item which is to be used within a custom combo box.

Example

The following example demonstrates how to define a custom toolbar combo box for use within EditLive! for XML on the Command Toolbar.

<editLive>
    ...
    <toolbars>
        <toolbar name="command">
            <customToolbarComboBox name="CustomCombo">
                <!--customToolbarComboBox settings-->
            </customToolbarComboBox>
        </toolbar name="command">
    </toolbars>
    ...
</editLive>

Remarks

The <customToolbarComboBox> element can appear multiple times within the <toolbar> element.