This element configures the manner in which Ephox EditLive! for XML reacts when text is imported from another HTML document, for example, from a Web browser.
This does not apply for HTML documents imported from Microsoft Word. For configuration settings for importing text from Microsoft Word please see the <wordImport> configuration element.
<htmlImport>
<editLive>
...
<htmlImport ... />
...
</editLive>This attribute specifies the user prompting and behaviour of EditLive! for XML upon detecting an import from Microsoft Word. This attribute has five possible values; user_prompt, merge_embedded_styles, merge_inline_styles, clean and plain_text.
The user_prompt setting will result in EditLive! for XML prompting the user as to whether they wish to import styles as inline or embedded styles or strip them from the imported text. The dialog used to prompt the user is the same as the Paste Special dialog.
The clean setting will result in EditLive! for XML stripping the styles from the imported text and only structural HTML elements will be imported, this includes <b>, <p> etc.
The merge_embedded_styles setting will result in EditLive! for XML importing styles from the content with the styles stored in the <head> of the document and class attributes will be applied where relevant.
The merge_inline_styles setting will result in EditLive! for XML importing styles from the content with style information applied inline inplace of class attributes.
The plain_text setting will strip out all style information from the imported text.
Styles imported from the content will not overwrite styles which already exist within the document.
For EditLive! for XML this should always be set to clean or merge_inline_styles.
The following example demonstrates how to set EditLive! for XML to prompt the user with style import options every time a HTML content import is detected.
<editLive>
...
<htmlImport styleOption="user_prompt" />
...
</editLive> The <htmlImport> element can appear only once within the <editLive> element.
If the <htmlImport> element is to be left blank the element must then be a complete tag, it cannot contain a tag body. Therefore the tag must be closed in the same line. It should appear as below:
<htmlImport styleOption=.../>
Copyright 2001-2005 Ephox Corporation. All Rights Reserved.