DEV Community

Cover image for How to Create DOM Elements from HTML Strings (Multiple Methods)
Zachary Lee
Zachary Lee

Posted on • Originally published at webdeveloper.beehiiv.com on

How to Create DOM Elements from HTML Strings (Multiple Methods)

When we need to create simple dynamic HTML DOM elements, we can use HTML string templates. There are many different methods to achieve this in JavaScript, but we might have some considerations.


innerHTML


const container = document.createElement('div');
container.innerHTML = `<div>Hello World</div>`;
const node = container.firstElementChild;
Enter fullscreen mode Exit fullscreen mode

This is one of the most common methods. Insert the HTML string into the innerHTML of a container element, and then access the generated DOM node.

However, it can only handle valid HTML nodes, i.e., elements that are legal in standard HTML structures. For example, if you try to insert a <tr> element into a <div>, the node will not be created.

Additionally, this method will not execute any scripts in the HTML string, which is safer when dealing with untrusted content.

innerHTML + template Element


const template = document.createElement('template');
template.innerHTML = `<div>Hello World</div>`;
const node = template.content.firstElementChild;
Enter fullscreen mode Exit fullscreen mode

The advantage of using the <template> tag is that it has no content restrictions and can contain any type of HTML structure, including table-related elements like <tr> and <td>.

insertAdjacentHTML


const container = document.createElement("div");
container.insertAdjacentHTML("afterbegin", `<div>Hello World</div>`);
const node = container.firstElementChild;
Enter fullscreen mode Exit fullscreen mode

This method is similar to innerHTML and can only handle valid HTML nodes. It also will not execute scripts.

DOMParser


const node = new DOMParser().parseFromString(`<div>Hello World</div>`, "text/html").body.firstElementChild;
Enter fullscreen mode Exit fullscreen mode

This method parses the string by creating a full HTML document and then extracts the node from the document. This means it is relatively slower than other solutions and is not recommended for use.

It can only handle valid HTML nodes and will not execute scripts.

Range.createContextualFragment


const node = document.createRange().createContextualFragment(`<div>Hello World</div>`).firstElementChild;

Enter fullscreen mode Exit fullscreen mode

This method is possibly the simplest. It also can only handle valid HTML nodes by default. However, we can set the context to avoid this.

Note that it will execute scripts in the HTML string, so be especially careful when dealing with untrusted content, such as using a cleaner like DOMPurify.

Conclusion

For different cases, you might need to choose the method that works best for you.

If you find my content helpful, please consider subscribing. I send a daily newsletter with the latest web development updates. Thanks for your support!

Top comments (2)

Collapse
 
efpage profile image
Eckehard

Anytime you create DOM elements programmatically, you will have to deal with some of this routines, so thank you much for this comprehensive list.

You might also want to ad some attributes like a class name or some inline styling to the new element, so the result might look like this:

const myDiv= document.createElement("div");
myDiv.setAttribute("class", "myClass")
const newtext = document.createTextNode("Hello World");
myDiv.appendChild(newtext)

let someNode = document.getElementById("myID");
someNode.appendChild(myDiv)
Enter fullscreen mode Exit fullscreen mode

Alternatively, this could be provided using innerHTML:

document.getElementById("myID").innerHTML = '<div class = "myClass">Hello World>/div>'
Enter fullscreen mode Exit fullscreen mode

This looks much shorter, but under the hood, the HTML parser needs to do the same.

Do you have any information abou the execution speed of both approaches?

Collapse
 
greenersoft profile image
GreenerSoft

It's at least 10 times faster with parseFromString(), for example, than generating elements with several lines of Javascript.

You can test it here:
greenersoft.fr/articles/eco-concep...