Django 模版高级进阶

tring[1:-1])这里需要说明的地方很多：每个标签编译函数有两个参数，parser和token。parser是模板解析器对象。 我们在这个例子中并不使用它。 token是正在被解析的语句。token.contents 是包含有标签原始内容的字符串。 在我们的例子中，它是'current_time "%Y-%m-%d %I:%M %p"' 。token.split_contents() 方法按空格拆分参数同时保证引号中的字符串不拆分。 应该避免使用token.contents.split() （仅使用Python的标准字符串拆分）。 它不够健壮，因为它只是简单的按照所有空格进行拆分，包括那些引号引起来的字符串中的空格。这个函数可以抛出 django.template.TemplateSyntaxError ，这个异常提供所有语法错误的有用信息。不要把标签名称硬编码在你的错误信息中，因为这样会把标签名称和你的函数耦合在一起。token.split_contents()[0]_总是_记录标签的名字，就算标签没有任何参数。这个函数返回一个 CurrentTimeNode （稍后我们将创建它），它包含了节点需要知道的关于这个标签的全部信息。 在这个例子中，它只是传递了参数 "%Y-%m-%d %I:%M %p" 。模板标签开头和结尾的引号使用format_string[1:-1] 除去。模板标签编译函数 必须 返回一个 Node 子类，返回其它值都是错的。编写模板节点编写自定义标签的第二步就是定义一个拥有 render() 方法的 Node 子类。 继续前面的例子，我们需要定义CurrentTimeNode ：import datetimeclass CurrentTimeNode(template.Node): def __init__(self, format_string): self.format_string = str(format_string) def render(self, context): now = datetime.datetime.now() return now.strftime(self.format_string)这两个函数（ init() 和 render() ）与模板处理中的两步（编译与渲染）直接对应。 这样，初始化函数仅仅需要存储后面要用到的格式字符串，而 render() 函数才做真正的工作。与模板过滤器一样，这些渲染函数应该静静地捕获错误，而不是抛出错误。 模板标签只允许在编译的时候抛出错误。注册标签最后，你需要用你模块的Library 实例注册这个标签。 注册自定义标签与注册自定义过滤器非常类似（如前文所述）。 只需实例化一个 template.Library 实例然后调用它的 tag() 方法。 例如：register.tag('current_time', do_current_time)tag() 方法需要两个参数:模板标签的名字（字符串）。编译函数。和注册过滤器类似，也可以在Python2.4及其以上版本中使用 register.tag装饰器：@register.tag(name="current_time")def do_current_time(parser, token): # ...@register.tagdef shout(parser, token): # ...如果你像在第二个例子中那样忽略 name 参数的话，Django会使用函数名称作为标签名称。在上下文中设置变量前一节的例子只是简单的返回一个值。 很多时候设置一个模板变量而非返回值也很有用。 那样，模板作者就只能使用你的模板标签所设置的变量。要在上下文中设置变量，在 render() 函数的context对象上使用字典赋值。 这里是一个修改过的CurrentTimeNode ，其中设定了一个模板变量 current_time ，并没有返回它：class CurrentTimeNode2(template.Node): def __init__(self, format_string): self.format_string = str(format_string) def render(self, context): now = datetime.datetime.now() context['current_time'] = now.strftime(self.format_string) return ''(我们把创建函数do_current_time2和注册给current_time2模板标签的工作留作读者练习。)注意 render() 返回了一个空字符串。 render() 应当总是返回一个字符串，所以如果模板标签只是要设置变量， render() 就应该返回一个空字符串。你应该这样使用这个新版本的标签：{% current_time2 "%Y-%M-%d %I:%M %p" %}The time is {{ current_time }}.但是 CurrentTimeNode2 有一个问题: 变量名 current_time 是硬编码的。 这意味着你必须确定你的模板在其它任何地方都不使用 {{ current_time }} ，因为 {% current_time2 %} 会盲目的覆盖该变量的值。一种更简洁的方案是由模板标签来指定需要设定的变量的名称，就像这样：{% get_current_time "%Y-%M-%d %I:%M %p" as my_current_time %}The current time is {{ my_current_time }}.为此，你需要重构编译函数和 Node 类，如下所示：import reclass CurrentTimeNode3(template.Node): def __init__(self, format_string, var_name): self.format_string = str(format_string) self.var_name = var_name def render(self, context): now = datetime.datetime.now() context[self.var_name] = now.strftime(self.format_string) return ''def do_current_time(parser, token): # This version uses a regular expression to parse tag contents. try: # Splitting by None == splitting by spaces. tag_name, arg = token.contents.split(None, 1) except ValueError: msg = '%r tag requires arguments' % token.contents[0] raise template.TemplateSyntaxError(msg) m = re.search(r'(.*?) as (\w+)', arg) if m: fmt, var_name = m.groups() else: msg = '%r tag had invalid arguments' % tag_name raise template.TemplateSyntaxError(msg) if not (fmt[0] == fmt[-1] and fmt[0] in ('"', "'")): msg = "%r tag's argument should be in quotes" % tag_name raise template.TemplateSyntaxError(msg) return CurrentTimeNode3(fmt[1:-1], var_name)现在 do_current_time() 把格式字符串和变量名传递给 CurrentTimeNode3 。分析直至另一个模板标签模板标签可以像包含其它标签的块一样工作（想想 {% if %} 、 {% for %} 等）。 要创建一个这样的模板标签，在你的编译函数中使用 parser.parse() 。标准的 {% comment %} 标签是这样实现的：def do_comment(parser, token): nodelist = parser.parse(('endcomment',)) parser.delete_first_token() return CommentNode()class CommentNode(template.Node): def render(self, context): return ''parser.parse() 接收一个包含了需要分析的模板标签名的元组作为参数。 它返