By Preact Team

 

You might have heard people refer to "Virtual DOM", and wondered: what makes it "virtual"? How is a "virtual" DOM different from the real DOM we use when programming for the browser?

 

A Virtual DOM is a simple description of a tree structure using objects:

 

let vdom = {
  type: 'p',         // a <p> element
  props: {
    class: 'big',    // with class="big"
    children: [
      'Hello World!' // and the text "Hello World!"
    ]
  }
}

 

Libraries like Preact provide a way to construct these descriptions, which can then be compared against the browser's DOM tree. As each part of the tree is compared, and the browser's DOM tree is updated to match the structure described by the Virtual DOM tree.

 

This is a useful tool, because it lets us compose user interfaces declaratively rather than imperatively. Instead of describing how to update the DOM in response to things like keyboard or mouse input, we only need to describe what the DOM should look like after that input is received. It means we can repeatedly give Preact descriptions of tree structures, and it will update the browser's DOM tree to match each new description – regardless of its current structure.

 

In this chapter, we'll learn how to create Virtual DOM trees, and how to tell Preact to update the DOM to match those trees.

 

Creating Virtual DOM trees

 

There are a few ways to create Virtual DOM trees:

 

  • createElement(): a function provided by Preact
  • JSX: HTML-like syntax that can be compiled to JavaScript
  • HTM: HTML-like syntax you can write directly in JavaScript

 

It's useful to start things off with the simplest approach, which would be to call Preact's createElement() function directly:

 

import { createElement, render } from 'preact';

let vdom = createElement(
  'p',              // a <p> element
  { class: 'big' }, // with class="big"
  'Hello World!'    // and the text "Hello World!"
);

render(vdom, document.body);

 

The code above creates a Virtual DOM "description" of a paragraph element. The first argument to createElement is the HTML element name. The second argument is the element's "props" - an object containing attributes (or properties) to set on the element. Any additional arguments are children for the element, which can be strings (like 'Hello World!') or Virtual DOM elements from additional createElement() calls.

 

The last line tells Preact to build a real DOM tree that matches our Virtual DOM "description", and to insert that DOM tree into the <body> of a web page.

 

Now with more JSX!

 

We can rewrite the previous example using JSX without changing its functionality. JSX lets us describe our paragraph element using HTML-like syntax, which can help keep things readable as we describe more complex trees. The drawback of JSX is that our code is no longer written in JavaScript, and must be compiled by a tool like Babel. Compilers do the work of converting the JSX example below into the exact createElement() code we saw in the previous example.

 

import { createElement, render } from 'preact';

let vdom = <p class="big">Hello World!</p>;

render(vdom, document.body);

 

It looks a lot more like HTML now!

 

There's one final thing to keep in mind about JSX: code inside of a JSX element (within the angle brackets) is special syntax and not JavaScript. To use JavaScript syntax like numbers or variables, you first need to "jump" back out from JSX using an {expression} - similar to fields in a template. The example below shows two expressions: one to set class to a randomized string, and another to calculate a number.

 

let maybeBig = Math.random() > .5 ? 'big' : 'small';

let vdom = <p class={maybeBig}>Hello {40 + 2}!</p>;
                 // ^---JS---^       ^--JS--^

 

If we were to render(vdom, document.body), the text "Hello 42!" would be shown.

 

Once more with HTM

 

HTM is an alternative to JSX that uses standard JavaScript tagged templates, removing the need for a compiler. If you haven't encountered tagged templates, they're a special type of String literal that can contain ${expression} fields:

 

let str = `Quantity: ${40 + 2} units`;  // "Quantity: 42 units"

 

HTM uses ${expression} instead of the {expression} syntax from JSX, which can make it clearer what parts of your code are HTM/JSX elements, and what parts are plain JavaScript:

 

import { html } from 'htm/preact';

let maybeBig = Math.random() > .5 ? 'big' : 'small';

let vdom = html`<p class=${maybeBig}>Hello ${40 + 2}!</p>`;
                        // ^--JS--^          ^-JS-^

 

All of these examples produce the same result: a Virtual DOM tree that can be given to Preact to create or update an existing DOM tree.

 

Detour: Components

 

We'll get into a lot more detail about Components later in this tutorial, but for now it's important to know that HTML elements like <p> are just one of two types of Virtual DOM elements. The other type is a Component, which is a Virtual DOM element where the type is a function instead of a string like p.

 

Components are the building blocks of Virtual DOM applications. For now, we'll create a very simple component by moving our JSX into a function, which will be rendered for us so we don't need to write that last render() line anymore:

 

import { createElement } from 'preact';

export default function App() {
    return (
        <p class="big">Hello World!</p>
    )
}