EditLive! 9 Documentation : image

This element defines the properties of an image stored on a server which is to be used with Ephox EditLive!.

Configuration File Element

<editLive>
     ...
     <mediaSettings>
          <images>
          ...
                <imageList>
                      <image ... />
                </imageList>
          </images>
     </mediaSettings>
     ...
</editLive>

Required Attributes

src

This attribute defines where the image can be found.

The URL can be absolute or relative. If a relative URL is specified it will be relative to the base attribute defined in the <httpUpload> element. If no base attribute has been defined and the URL is relative then the URL will be relative to the base of the page in which the instance of EditLive! resides.

Optional Attributes

align

This attribute has the same effect as the align property of the <IMG> HTML tag. It affects the alignment of text which is placed after the image reference. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

alt

This attribute has the same effect as the alt property of the <IMG> HTML tag. This attribute defines the alternative text to be displayed when the image cannot be loaded into a HTML page. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

border

This attribute has the same effect as the border property of the <IMG> HTML tag. This attribute specifies the width of the border, in pixels, around the image. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

description

This attribute specifies the description used for the image in the Server Image Dialog within EditLive!.

height

This attribute has the same effect as the height property of the <IMG> HTML tag. This attribute specifies the height of the image in pixels. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

hspace

This attribute has the same effect as the hspace property of the <IMG> HTML tag. This attribute specifies the horizontal spacing around the image in pixels (ie. left and right side padding). When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

name

This attribute has the same effect as the title property of the <IMG> HTML tag. This attribute defines the name for the image. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

title

This attribute specifies the title used for the image in the Server Image Dialog within EditLive!.

vspace

This attribute has the same effect as the vspace property of the <IMG> HTML tag. This attribute specifies the vertical spacing around the image in pixels (ie. top and bottom padding). When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

width

This attribute has the same effect as the width property of the <IMG> HTML tag. This attribute specifies the width of the image in pixels. When inserting the image defined by this <image> element into an EditLive! document this attribute will appear in the source code.

Example

The following example demonstrates how to configure a server image for use with EditLive!.

<editLive>
    ...
    <mediaSettings>
        <images>
            ...
            <imageList>
                <image align="left" 
                    alt="Alternative Text" 
                    border="1" 
                    description="A Server Image"
                    height="500" width="250" 
                    src="http://yourserver.com/" 
                 />
            ...
            </imageList>
        </images>
    </mediaSettings>
    ...
</editLive>

Remarks

The <image> element can appear multiple times within the <imageList> element.

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

<image src=... />