Python的Django框架中自定义模版标签的示例
为了自定义一个模板标签,你需要告诉Django当遇到你的标签时怎样进行这个过程。
当Django编译一个模板时,它将原始模板分成一个个节点。每个节点都是django.template.Node的一个实例,并且具备render()方法。于是,一个已编译的模板就是节点对象的一个列表。例如,看看这个模板:
Hello,{{person.name}}. {%ifequalname.birthdaytoday%} Happybirthday! {%else%} Besuretocomebackonyourbirthday forasplendidsurprisemessage. {%endifequal%}
被编译的模板表现为节点列表的形式:
- 文本节点:"Hello,"
- 变量节点:person.name
- 文本节点:".\n\n"
- IfEqual节点:name.birthday和today
当你调用一个已编译模板的render()方法时,模板就会用给定的context来调用每个在它的节点列表上的所有节点的render()方法。这些渲染的结果合并起来,形成了模板的输出。因此,要自定义模板标签,你需要指明原始模板标签如何转换成节点(编译函数)和节点的render()方法完成的功能。
在下面的章节中,我们将详细解说写一个自定义标签时的所有步骤。