Page tree
Skip to end of metadata
Go to start of metadata

This element contains the configuration information for an inline toolbar for use within EditLive!. Items will appear in a toolbar in EditLive!, from left to right, in the order that they appear in the EditLive! configuration document.

Configuration Element Tree Structure

<editLive>
<inlineToolbars>
<inlineToolbar>

<editLive>
     ...
     <inlineToolbars>
          <inlineToolbar ...>
               <!--toolbar configuration settings-->
          </inlineToolbar>
     </inlineToolbars>
     ...
</editLive>

Required Attributes

name

An identifying name for this toolbar. Inline toolbars are generated by Tiny for editing specific HTML elements. The following inline toolbars are currently available for EditLive!:

  • img - An inline toolbar which will appear when selecting an IMG element in EditLive!.

    In order to enable the image inline toolbar, you need to include a <plugin> element containing a name attribute with the value imageEditor. For more information on EditLive!'s Image Editor functionality, please read the Image Editing article.

    Example

    <editlive>
           ...
           <plugins>
                   <plugin name="imageEditor" />
           </plugins>
     
                 <inlineToolbars>
                     <inlineToolbar name="img">
                           <!--toolbar configuration settings-->
                     </inlineToolbar>
                 </inlineToolbars>
    </editlive>
  • table - An inline toolbar which will appear when selecting a TABLE element or any of its children elements in EditLive!.

    In order to enable the table inline toolbar, you need to include a <plugin> element containing a name attribute with the value tableToolbar.

    Example

    <editlive>
           ...
           <plugins>
                   <plugin name="tableToolbar" />
           </plugins>
     
                 <inlineToolbars>
                     <inlineToolbar name="table">
                           <!--toolbar configuration settings-->
                     </inlineToolbar>
                 </inlineToolbars>
    </editlive>

Child Elements

<toolbarButton>

This element will cause a particular button to be present on the toolbar within EditLive!.

<toolbarButtonGroup>

This element will cause a particular group of buttons to be present on the toolbar within EditLive!. The operation of these buttons within EditLive! will be mutually exclusive. The buttons added by this element can only be added and removed from the toolbar as a group. For example, the alignment buttons are a button group as Align Left cannot be activated at the same time as Align Right.

<toolbarComboBox>

This element will cause a particular combo box to be present on the toolbar within EditLive!.

<toolbarSeparator>

This element will cause the appearance of a vertical separating line between toolbar elements.

<customToolbarButton>

This element specifies the properties for a developer defined custom toolbar button for use within EditLive!.

<customToolbarComboBox>

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

Example

This example demonstrates how to declare inline toolbars for IMG and TABLE HTML elements.

<editLive>
  ...
  <inlineToolbars>
    ...
    <inlineToolbar name="img">
      ...
    </inlineToolbar>
    <inlineToolbar name="table">
      ...
    </inlineToolbar>
    ...
  </inlineToolbars>
  ...
</editLive>

Remarks

The <inlineToolbar> element can appear multiple times within the <inlineToolbars> element.

See Also

  • No labels