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()方法完成的功能 。
在下面的章节中,我们将详细解说写一个自定义标签时的所有步骤。