This element configures the manner in which Tiny EditLive! reacts when text is imported from Microsoft Word.
Configuration Element Tree Structure
<editLive>
<wordImport>
<editLive>
...
<wordImport ... />
...
</editLive>
Optional Attributes
styleOption
This attribute specifies the user prompting and behaviour of EditLive! upon detecting an import from Microsoft Word. This attribute has five possible values:
- user_prompt - Users will be prompted as to whether they wish to import Microsoft Word 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.
- merge_embedded_styles - This setting will result in EditLive! importing styles from Microsoft Word with the styles stored in the <head> of the document and class attributes will be applied where relevant.
- merge_inline_styles - This setting will result in EditLive! importing styles from Microsoft Word with style information applied inline in place of class attributes.
- clean - The clean setting will result in EditLive! stripping the Microsoft Word Styles from the imported text. Only structural HTML elements will be imported, such as <b>, <p>, etc.
- plain_text - The plain_text setting will strip out all style information from the imported text.
Styles imported from Microsoft Word will not overwrite styles which already exist within the document.
cleanOption
This boolean value specifies whether the Clean HTML option will appear in the Paste Special... dialog.
Default value: true
mergeInlineStylesOption
This boolean value specifies whether the Styled HTML (Inline) option will appear in the Paste Special... dialog.
Default value: true
mergeEmbeddedStylesOption
This boolean value specifies whether the Styled HTML (Embedded) option will appear in the Paste Special... dialog.
Default value: true
plainTextOption
This boolean value specifies whether the Plain Text option will appear in the Paste Special... dialog.
Default value: true
Example
The following example demonstrates how to set EditLive! to prompt the user with style import options every time a Microsoft Word import is detected.
<editLive>
...
<wordImport styleOption="user_prompt" />
...
</editLive>
Remarks
The <wordImport> element can appear only once within the <editLive> element.
If the <wordImport> 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:
<wordImport styleOption=.../>