QWeb是一个基于xml的模板引擎，用于生成HTML片段和页面，模板指令是写在xml标签中的以t-开头的属性，比如t-if
如果要让一个标签不被渲染，可以采用t来包裹，这样会执行它里面的命令但是不产生任何输出
Test
#condtition为true时上述代码会输出：Test
Test
#condtition为true时上述代码会输出：
Test
数据输出
Qweb有一个自动过滤xss和html的输出命令esc，它接受一个表达式，解析变输出结果：
#当value值为42时输出结果：
42
还有一个raw参数与esc类似，但不过滤html，用于显示处理好的html内容
条件语句
qweb有一个if条件判断指令，会自动解析其对应的属性值里的表达式：
ok
#当condition是true的时候解析成：
ok
#condition为false的时候解析成
#也可用下面的方法实现一样的功能
ok
另外，t-elif和t-else可用于添加条件分支
Happy bithday!
Welcome master!
Welcome!
循环
Qweb有一个指令用于循环处理，t-foreach用来指定需要循环处理的数据，t-as提供的是在后面用于代表当前项目的变量名：
#上述语句输出：
1
2
3
#也可用下面的方法实现一样的功能
foreach可用于数组（当前项目即是值）、映射表（当前项目是key）、整形数字（相当于0-X的数组）
* $as_all - 被循环的对象
* `$as_value` - 当前循环的值，当处理列表和数字时与 `$as`是一样的，当处理映射表时它代表值，而`$as`代表的是键
* $as_index - 当前循环索引，第0开始计算
* $as_size - 被循环对象的大小
* $as_first - 当前项目是否是第一个，相当于$as_index == 0
* $as_last - 当前项目是否是最后一个，相当于$as_index + 1 == $as_size
* $as_parity - 当前项目是奇数个还是偶数
* $as_even - 当前项目索引是否为奇数
* $as_odd - 当前项目索引是否为偶数
上述参数只在foreach里面可用，但可在循环的最后复制到全局环境中
属性
qweb可以对属性进行实时计算并在输出时设置，通过t-attr来实现，有三种形式：
-
t-att-$name可以创建一个名为$name的属性，原属性的值会被解析为新生成的属性的值
#输出
-
t-attf-$name与第一个类似，但它的值是一个格式化字符串而不是表达式，一般用于字符+变量组合如：
#输出：
1
2
3
-
t-att=mapping如果参数是映射表，每个键值对会生成一个属性：
#输出
-
t-att=pair如果参数是元组或2个元素的数组，那么第一个项就作为属性名，第二个作为属性值
#输出
设置变量
qweb允许在模板内设置变量（用于记住一个计算结果、或为数据定义一个更明确的名字）
使用t-set来实现，它的值就是设置的变量名
- t-value属性是一个表达式，解析后的值作为新变量的值
- 如果没有t-value，节点的内容会被渲染被设置成变量的值
ok
调用子模板
qweb可以用于最高级别的渲染，但也可以通过t-call来包含其他模板
如果other-template是
1
这个有一个问题，在t-call外其他位置会可见。在t-call内设置的内容会在调用子模板时先执行并更新到当前环境
t-call内包含的内容可以通过一个0的魔术变量来传递给被调用的模板：
#other-template
This template was called with content:
content
#output
This template was called with content:
content
Python
专用指令：
自动格式化记录
-
t-field只能用于格式化记录字段（从browe函数获取到的），可以根据字段类型自动匹配格式； -
t-options只能用于自定义字段，最常用的是widget，其他的选项都是field-xx或widget-xx
调试器（t-debug）
通过PDB 的set_trace 来进行调试，接收的参数需要是模块名字，set_trace()会在该模块上调用
Helpers
基于请求的Helper
python端一般是在controller里使用qweb，这样可以直接调用odoo.http.HttpRequest.render()来渲染保存在数据库中的模板
response = http.request.render('my-template', {
'context_value': 42
})
#会直接从controller里返回一个响应对象
基于视图的Helper
比上面的更深层次的helper是在ir.ui.view:中的render方法
- render(cr, uid, id[, values][, engine='ir.qweb][, context])
通过view的数据库id来渲染一个qweb视图模板，模板在ir.ui.view记录会自动加载，它会为渲染环境设置一系列默认值 - request - 当前WebRequest对象
- debug - 当前请求是否是debug模式
- quote_plus - 是否进行url encode转义
- json - 相关的标准库
- time - 相关的标准库
- datetime - 相关的标准库
- relativedelta - model的时间处理属性
- keep_query - 一个keep_query函数，参数1：values-传递给qweb的上下文环境，参数2：engine (str) 用于qweb渲染的odoo模型名
API
可以直接使用ir.qweb模型来继承、扩展他的功能
Javascript
专用指令
- 定义模板
t-name只能放在模板文件的最外面，离template标签最近的地方
它没有其他参数，但可以使用一个t标签，当使用t标签时它需要有单个子元素，模板名可以随便取，一般会用.分隔来表示继承关系
- 模板继承
模板继承是用来修改已存在的模板，即给在其他模块定义的模板添加内容。通过t-extend来表示，它的值是被继承的模板名，通过t-jquery来进行修改
new element
t-jquery给出的是一个css选择器，用于选择需要改变的节点，并通过t-operation指定需要进行的操作
- append - 新节点的内容添加到原节点的后面（最后一个子节点后）
- prepend - 新节点内容添加到原节点前面（第一个子节点前）
- before - 新节点内容添加到原节点前
- after - 新节点内容添加到原节点后
- inner - 新节点内容替换原节点的子节点
- replace - 新节点内容直接替换原节点
如果没有指定operation，那么模板内容会被解析成javascript节点，并将context节点设置为this
调试
qweb的javascript提供多种调试工具
t-log
接收一个表达式参数，在渲染时解析并将结果输出到控制台
t-debug
在渲染时触发一个调试断点
t-js
该节点内容里的javascript代码会在渲染时执行，接收一个context参数，将当前的环境传给js
console.log("Foo is", ctx.foo);
Helpers
core.qweb(core是web.core模块):一个 QWeb2.Engine()实例，在这个实例中所有模块相关模板文件全部有加载，而且可使用_(underscore方法), _t(翻译方法) 和 JSON
core.qweb.render 可以用于渲染基本模块的模板
API
class QWeb2.Engine()
QWeb渲染器，处理qweb的大部分逻辑如加载、解析、编译、渲染
odoo在core模块中将user实例化，并输出到core.qweb，同时将所有模板文件加载到qweb实例中
一个 QWeb2.Engine()同时也可以当成一个命名空间来看待
- QWeb2.Engine.render(template[, context])
将一个模板渲染成字符串，使用context来查找渲染时所遇到的变量
参数：1.template (String) - 需要渲染的模板名
2.context (Object) - 渲染时需要用到的命名空间
QWeb2.Engine.add_template(templates)
这个方法在某些情况下比较有用，用于自己定义一个命名空间并获得单独的 QWeb2.Engine()实例，这样不要担心与其他模块冲突。
该方法加载指定的模板，参数可以是以下几种：
1.XML字符串 -- Qweb会将它解析成xml文档并加载
2.URL -- Qweb会下载对应的url内容，并加载获得的xml字符串
3.Document 或 Node -- qweb会将所有第一级的子节点过滤一遍，并加载命名为template或从template继承的部分
QWeb2.Engine.prefix
在解析的时候用来识别指令的前缀，默认是t
QWeb2.Engine.debug
布尔型标志表示引擎是否使用调试模式，默认情况下，qweb会把模板执行过程中产生的错误拦截，在调试模式下，所有异常都会被保留
QWeb2.Engine.jQuery
在模板继承处理时所使用的jQuery实例，默认是window.jQuery
QWeb2.Engine.preprocess_node
一个方法，当它出现时会在编译dom节点和template节点前调用，一般用于自动模板中的翻译文本内容或属性，默认是null
译自odoo官方文档：http://www.odoo.com/documentation/10.0/reference/qweb.html ，不当之处欢迎批评指正。
内容发布自http://www.jianshu.com/u/6fdae8ec06bc，转载请注明出处