--
The insertAdjacentHTML() method parses the specified text as HTML or XML and inserts the resulting nodes into the DOM tree at a specified position. It does not reparse the element it is being used on, and thus it does not corrupt the existing elements inside that element. This avoids the extra step of serialization, making it much faster than direct innerHTMLmanipulation.
Syntax
element.insertAdjacentHTML(position, text);
Parameters
position- A
DOMStringrepresenting the position relative to theelement; must be one of the following strings:'beforebegin': Before theelementitself.'afterbegin': Just inside theelement, before its first child.'beforeend': Just inside theelement, after its last child.'afterend': After theelementitself.
texttextis the string to be parsed as HTML or XML and inserted into the tree.
Visualization of position names
<!-- beforebegin -->
<p>
<!-- afterbegin -->
foo
<!-- beforeend -->
</p>
<!-- afterend -->Example
// <div id="one">one</div>
var d1 = document.getElementById('one');
d1.insertAdjacentHTML('afterend', '<div id="two">two</div>');
// At this point, the new structure is:
// <div id="one">one</div><div id="two">two</div>Notes
Security Considerations
When inserting HTML into a page by using insertAdjacentHTML be careful not to use user input that hasn't been escaped.
It is not recommended you use insertAdjacentHTML when inserting plain text; instead, use the Node.textContent property or Element.insertAdjacentText() method. This doesn't interpret the passed content as HTML, but instead inserts it as raw text.
Specification
| Specification | Status | Comment |
|---|---|---|
| DOM Parsing and Serialization The definition of 'Element.insertAdjacentHTML()' in that specification. | Working Draft |
Browser compatibility
| 1 | 12 | 8 | 4 | 7 | 4 | 2.3 | 18 | 12 | 8 | Yes | 4 | Yes |
Legend
- Full support
- See implementation notes.
See also
Element.insertAdjacentElement()Element.insertAdjacentText()XMLSerializer: Construct a DOM representation of XML text- hacks.mozilla.org guest post

