python的django框架中自定义模版标签的示例

为了自定义一个模板标签,你需要告诉django当遇到你的标签时怎样进行这个过程。

当django编译一个模板时,它将原始模板分成一个个 节点 。每个节点都是 django.template.node 的一个实例,并且具备 render() 方法。 于是,一个已编译的模板就是 节点 对象的一个列表。 例如,看看这个模板:

hello, {{ person.name }}.
{% ifequal name.birthday today %}
happy birthday!
{% else %}
be sure to come back on your birthday
for a splendid surprise message.
{% endifequal %}

被编译的模板表现为节点列表的形式:

文本节点: “hello, ”
变量节点: person.name
文本节点: “.\n\n”
ifequal节点: name.birthday和today

当你调用一个已编译模板的 render() 方法时,模板就会用给定的context来调用每个在它的节点列表上的所有节点的 render() 方法。 这些渲染的结果合并起来,形成了模板的输出。 因此,要自定义模板标签,你需要指明原始模板标签如何转换成节点(编译函数)和节点的render()方法完成的功能 。

在下面的章节中,我们将详细解说写一个自定义标签时的所有步骤。

Posted in 未分类