owl/doc/qweb.md

🦉 QWeb 🦉

QWeb is a template specification. The QWeb class in this repository is:

• an implementation of the QWeb specification
• which outputs a virtual dom instead of a string
• and extended with a few extra directives

QWeb Specification

add here a full description of what QWeb is supposed to be, with some examples

QWeb Implementation

var qweb = new QWeb();
qweb.addTemplate("sometemplate", '<div>hello <t t-esc="name"/></div>');

// result is a vnode which represent <div>hello world</div>
result = qweb.render("sometemplate", { name: "world" });

QWeb extensions

• t-on directive
• t-widget, t-props, t-key
• t-ref

Note on white spaces

White spaces in a templates are handled in a special way:

• consecutive whitespaces are always condensed to a single whitespace
• if a whitespace-only text node contains a linebreak, it is ignored
• the previous rules do not apply if we are in a <pre> tag