django-tag-parser 3.1

参数和关键字参数

要分析如下语法：

{%my_tag"arg1"keyword1="bar"keyword2="foo"%}

使用：

fromdjango.templateimportLibraryfromtag_parser.basetagsimportBaseNoderegister=Library()@register.tag('my_tag')classMyTagNode(BaseNode):max_args=1allowed_kwargs=('keyword1','keyword2',)defrender_tag(self,context,*tag_args,**tag_kwargs):return"Tag Output"

包含标签

使用可覆盖的模板名创建包含标记：

{%my_include_tag"foo"template="custom/example.html"%}

使用：

fromdjango.templateimportLibraryfromtag_parser.basetagsimportBaseInclusionNoderegister=Library()@register.tag("my_include_tag")classMyIncludeTag(BaseInclusionNode):template_name="mytags/default.html"max_args=1defget_context_data(self,parent_context,*tag_args,**tag_kwargs):(foo,)=*tag_argsreturn{'foo':foo}

也可以重写get_template_name()方法以支持模板名称的动态解析。 默认情况下，它检查template标记夸格和template_name属性。 注意，模板节点随后被缓存，不可能在每次调用时返回随机模板。

作业标签

要创建可以呈现自身或返回上下文数据的赋值标记，请执行以下操作：

{%get_tagstemplate="custom/example.html"%}{%get_tagsaspopular_tags%}

使用：

fromdjango.templateimportLibraryfromtag_parser.basetagsimportBaseAssignmentOrInclusionNoderegister=Library()@register.tag('get_tags')classGetPopularTagsNode(BaseAssignmentOrInclusionNode):template_name="myblog/templatetags/popular_tags.html"context_value_name='tags'allowed_kwargs=('order','orderby','limit',)defget_value(self,context,*tag_args,**tag_kwargs):returnquery_tags(**tag_kwargs)# Something that reads the tags.

块标记

开始…end“块，在类中定义end_tag_name：

{%my_tagkeyword1=foo%}
    Tag contents, possibly other tags.
{%end_my_tag%}

使用：

fromdjango.templateimportLibraryfromtag_parser.basetagsimportBaseAssignmentOrInclusionNoderegister=Library()@register.tag('my_tag')classMyTagNode(BaseNode):max_args=1allowed_kwargs=('keyword1','keyword2',)end_tag_name='end_my_tag'defrender_tag(self,context,*tag_args,**tag_kwargs):# Render contents insidereturnself.nodelist.render(context)

自定义解析

使用django的标准Node类，可以更容易地实现自定义语法。 例如，要解析：

{%getfirstofval1val2asval3%}

使用：

fromdjango.templateimportLibrary,Node,TemplateSyntaxErrorfromtag_parserimportparse_token_kwargs,parse_as_varregister=Library()@register.tag('getfirstof')classGetFirstOfNode(Node):def__init__(self,options,as_var):self.options=options# list of FilterExpression nodes.self.as_var=as_var@classmethoddefparse(cls,parser,token):bits,as_var=parse_as_var(parser,token)tag_name,options,_=parse_token_kwargs(parser,bits,allowed_kwargs=())ifas_varisNoneornotchoices:raiseTemplateSyntaxError("Expected syntax: {{% {0} val1 val2 as val %}}".format(tag_name))returncls(options,as_var)defrender(self,context):value=Noneforfilterexprinself.options:# The ignore_failures argument prevents that the value becomes TEMPLATE_STRING_IF_INVALID.value=filterexpr.resolve(context,ignore_failures=True)ifvalueisnotNone:breakcontext[self.as_var]=valuereturn''

贡献

本模块设计为通用模块。万一你有什么不喜欢的， 或者认为它不够灵活，请让我们知道。我们很乐意改进它！

如果你有其他有价值的贡献、建议或想法， 请也让我们知道，因为我们会调查的。 也欢迎拉取请求。：-）