applyElement method (Windows)

This topic has not yet been rated - Rate this topic

Makes the element either a child or parent of another element.

Syntax

object.applyElement(apply, where)

Parameters

apply [in]

Type: IHTMLElement

An object that becomes the child or parent of the current element.

where [in, optional]

Type: String

A String that specifies one of the following values.

outside: Default. Specified element becomes a parent of the current element.
inside: Specified element becomes a child of the current element, but contains all the child elements of the current element.

Return value

Type: IHTMLElement

Returns a reference to the applied element.

Standards information

There are no standards that apply here.

Remarks

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.

If you call the applyElement method on an element that was created with the createElement method, but not yet added to the document tree, the element will lose the contents of its innerHTML property.

Examples

This example uses the applyElement method to apply the i element to an unordered list.


<!DOCTYPE html>
<html >
<head>
      <title>Apply Element example</title>
</head>
<body>
  <script type="text/javascript">
    function fnApply() {
      var oNewNode = document.createElement("i");
      document.getElementById("oList").applyElement(oNewNode);
    }
</script>
<ul id = oList>
<li>List item 1</li>
<li>List item 2</li>
<li>List item 3</li>
<li>List item 4</li>
</ul>
<input
   type="button"
   value="Apply Element"
   onclick="fnApply()"
>

</body>
</html>

applyElement method