分析直至另一個模板標(biāo)簽

模板標(biāo)簽可以像包含其它標(biāo)簽的塊一樣工作（想想 {% if %} 、 {% for %} 等）。 要創(chuàng)建一個這樣的模板標(biāo)簽，在你的編譯函數(shù)中使用 parser.parse() 。

標(biāo)準(zhǔn)的 {% comment %} 標(biāo)簽是這樣實(shí)現(xiàn)的：

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() 接收一個包含了需要分析的模板標(biāo)簽名的元組作為參數(shù)。 它返回一個django.template.NodeList實(shí)例，它是一個包含了所有Node對象的列表，這些對象是解析器在解析到任一元組中指定的標(biāo)簽之前遇到的內(nèi)容.

因此在前面的例子中， nodelist 是在 {% comment %} 和 {% endcomment %} 之間所有節(jié)點(diǎn)的列表，不包括 {% comment %} 和 {% endcomment %} 自身。

在 parser.parse() 被調(diào)用之后，分析器還沒有清除 {% endcomment %} 標(biāo)簽，因此代碼需要顯式地調(diào)用 parser.delete_first_token() 來防止該標(biāo)簽被處理兩次。

之后 CommentNode.render() 只是簡單地返回一個空字符串。 在 {% comment %} 和 {% endcomment %} 之間的所有內(nèi)容都被忽略。
分析直至另外一個模板標(biāo)簽并保存內(nèi)容

在前一個例子中， do_comment() 拋棄了{(lán)% comment %} 和 {% endcomment %} 之間的所有內(nèi)容。當(dāng)然也可以修改和利用下標(biāo)簽之間的這些內(nèi)容。

例如，這個自定義模板標(biāo)簽{% upper %}，它會把它自己和{% endupper %}之間的內(nèi)容變成大寫：

{% upper %}
  This will appear in uppercase, {{ user_name }}.
{% endupper %}

就像前面的例子一樣，我們將使用 parser.parse() 。這次，我們將產(chǎn)生的 nodelist 傳遞給 Node ：

def do_upper(parser, token):
  nodelist = parser.parse(('endupper',))
  parser.delete_first_token()
  return UpperNode(nodelist)

class UpperNode(template.Node):
  def __init__(self, nodelist):
    self.nodelist = nodelist

  def render(self, context):
    output = self.nodelist.render(context)
    return output.upper()

這里唯一的一個新概念是 UpperNode.render() 中的 self.nodelist.render(context) 。它對節(jié)點(diǎn)列表中的每個 Node 簡單的調(diào)用 render() 。

最新評論