pasteHTML

HTML (DHTML)

pasteHTML Method

Internet Development Index

Pastes HTML text into the given text range, replacing any previous text and HTML elements in the range.

Syntax

TextRange.pasteHTML(sHTMLText)

Parameters

sHTMLText Required. String that specifies the HTML text to paste. The string can contain text and any combination of the HTML tags described in HTML Elements.

Return Value

No return value.

Remarks

This method might alter the HTML text to make it fit the given text range. For example, pasting a table cell into a text range that does not contain a table might cause the method to insert a table element. For predictable results, paste only well-formed HTML text that fits within the given text range.

This method fails only when used inappropriately to paste HTML into a TEXTAREA element in Microsoft® Internet Explorer 5 and later.

This method is accessible at run time. If elements are removed at run time, before the closing tag is parsed, areas of the document might not render.

This feature might not be available on non-Microsoft Win32® platforms.

Example

This example uses the pasteHTML method to replace the current selection with a new paragraph.

<SCRIPT LANGUAGE="JScript">
var sel = document.selection;
if (sel!=null) {
var rng = sel.createRange();
if (rng!=null)
rng.pasteHTML("<P><B>Selection has been replaced.</B></P>");
}
</SCRIPT>

Standards Information

There is no public standard that applies to this method.

Applies To

TextRange