<comboBoxItem> Element

This element contains the information required by Ephox EditLive! for Java to configure an item within one of the EditLive! for Java combo boxes. 

Element Tree Structure

<editLiveForJava>
    <toolbars>
        <formatToolbar> OR <commandToolbar>
            <toolbarComboBox>
                <comboBoxItem>

<editLiveForJava>
     ...
     <toolbars>
          <formatToolbar> OR <commandToolbar>*
               <toolbarComboBox ... >
                    <comboBoxItem ... />
               </toolbarComboBox>
          </formatToolbar> OR </commandToolbar>*
     </toolbars>
     ...
</editLiveForJava>

*Note:  The <toolbarComboBox> 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 Style Combo Box

This attribute gives the value to be used when the item is being inserted into the HTML source code.  When used in the Style combo box the name attribute gives the name of the tag inserted into the HTML source code within EditLive! for Java.

Example:
If the name attribute was set to H1 then the <H1> tag would be inserted into the HTML when this style was used.

Typeface Combo Box

This attribute gives the value to be used when the item is being inserted into the HTML source code.  When used in the Typeface combo box the name attribute gives the value used for the face attribute within the <FONT> tag used within the EditLive! for Java HTML source code.

Example:
If the name attribute was set to Times New Roman then the following <FONT> tag would be inserted into the EditLive! for Java HTML source code:
     <FONT face="Times New Roman">

Size Combo Box

This attribute gives the value to be used when the item is being inserted into the HTML source code.  When used in the Size combo box the name attribute gives the value used for the size attribute within the <FONT> tag used within the EditLive! for Java HTML source code.

Note:  The name attribute for the Size combo box must be between 1 and 7, inclusive.

Example:
If the name attribute was set to 3 then the following <FONT> tag would be inserted into the EditLive! for Java HTML source code:
     <FONT size="3">

Optional Attributes

Attribute Description
text This attribute gives the value which appears inside the relevant combo box within EditLive! for Java (eg. Heading 1, Normal, 12pt, Times New Roman).

Example

The following example adds the H1 style to the Style combo box so that it appears as "Heading 1" inside the combo box in EditLive! for Java.  Also added is the Arial font to the Typeface combo box and it is listed as "Company Font" in the combo box in EditLive! for Java.  Finally the HTML font size 3 is added to the Size combo box and lists it as "12pt" in the combo box in EditLive! for Java.

All the combo boxes in this example are added to the Format Toolbar.

<editLiveForJava>
    ...
    <toolbars>
        <formatToolbar>
            <toolbarComboBox name="tlbStyle">
                <comboBoxItem name="H1" text="Heading 1"/>
            </toolbarComboBox>
            <toolbarComboBox name="tlbFace">
                <comboBoxItem name="Arial" text="Company Font"/>
            </toolbarComboBox>
            <toolbarComboBox name="tlbSize">
                <comboBoxItem name="3" text="12pt"/>
            </toolbarComboBox>
        </formatToolbar>
    </toolbars>
    ...
</editLiveForJava>

Remarks

The <comboBoxItem> element can appear multiple times within the <toolbarComboBox> element.

The <comboBoxItem> 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:

    <comboBoxItem name=... />

See Also