Django从理论到实战(part19)--DTL模板语法

    技术2025-01-12  19

    学习笔记,仅供参考

    参考自:Django打造大型企业官网–Huang Y;官方文档

    本系列Blog以应用为主,理论基础部分我在后端专栏的Django系列博客已经写过了,如果有些需要补充的知识点,我会在这个系列中,尽量详细的记录一下。


    文章目录

    DTL模板语法变量常用标签`if`标签`for...in...`标签`for...in...empty`标签`with`标签`url`标签`spaceless`标签`autoescape`标签`verbatim`标签


    DTL模板语法

    变量

    模板中可以包含变量,Django在渲染模板的时候,可以传递变量对应的值过去进行替换。变量的命名规范和Python非常类似,只能是阿拉伯数字和英文字符以及下划线的组合,不能出现标点符号等特殊字符,例如:

    {# profile.html模板代码 #} <p>{{ username }}</p>

    模板中的变量同样也支持点.的形式,比如person.username,模板是按照以下方式进行解析的:

    如果person是一个字典,那么就会查找这个字典的username这个key对应的值。

    如果person是一个对象,那么就会查找这个对象的username属性,或者是username这个方法。

    如果出现的是person.0,则Django会判断persons是否是一个列表或者元组或者任意的可以通过下标访问的对象,如果是的话就取这个列表的第1个值,如果不是,获取到的就是一个空的字符串。

    常用标签

    if标签

    if标签相当于Python中的if语句,有elif和else相对应,但是所有的标签都需要用标签符号({%%})进行包裹。if标签中可以使用==、!=、<、<=、>、>=、in、not in、is、is not等判断运算符,例如:

    {% if "张三" in persons %} <p>张三</p> {% else %} <p>李四</p> {% endif %}

    for...in...标签

    for...in...标签类似于Python中的for...in...。可以遍历列表、元组、字符串、字典等一切可以遍历的对象,例如:

    {% for person in persons %} <p>{{ person.name }}</p> {% endfor %}

    如果想要反向遍历,那么在遍历的时候就加上一个reversed,例如:

    {% for person in persons reversed %} <p>{{ person.name }}</p> {% endfor %}

    在python中,需要使用items、keys和values等方法遍历字典,在DTL中,执行上述方法的语法如下:

    {% for key,value in person.items %} <p>key:{{ key }}</p> <p>value:{{ value }}</p> {% endfor %}

    在for循环中,DTL提供了一些变量供我们使用,详见下表:

    变量解释forloop.counter当前循环的下标,以1作为起始值forloop.counter0当前循环的下标,以0作为起始值forloop.revcounter0类似于forloop.revcounter,不同的是最后一个元素的下标是从0开始forloop.revcounter当前循环的反向下标值,比如列表有5个元素,那么第一次遍历这个属性是等于5,第二次是4,以此类推。并且是以1作为最后一个元素的下标forloop.first是否是第一次遍历forloop.last是否是最后一次遍历forloop.parentloop如果有多个循环嵌套,那么这个属性代表的是上一级的for循环

    for...in...empty标签

    该标签使用跟for...in...是一样的,只不过是在遍历的对象如果没有元素的情况下,会执行empty中的内容,例如:

    {% for person in persons %} <li>{{ person }}</li> {% empty %} 无元素 {% endfor %}

    with标签

    该标签可以帮助我们在模版中定义变量。有时候一个变量的访问比较复杂,那么可以先把这个变量缓存到另一个变量上,之后就可以直接使用这个变量了,例如:

    #视图模块中 context = { "persons": ["小黄","大白"] } #模板文件中 {% with lisi=persons.1 %} <p>{{ lisi }}</p> {% endwith %}

    还有另外一种写法:

    {% with persons.1 as lisi %} <p>{{ lisi }}</p> {% endwith %}

    需要注意的是:

    在with语句中定义的变量,只能在{%with%}{%endwith%}中使用,不能在这个标签外面使用;定义变量的时候,不能在等号左右两边留有空格,比如,{% with lisi = persons.1%}是错误的。

    url标签

    在模版中,我们经常要写一些url,比如在a标签中定义href属性,如果我们通过硬编码的方式直接将这个url写死也是可以的,但是这样对于以后项目维护可能不是一件好事,因此建议使用反转的方式来实现,类似于django中的reverse一样,例如:

    <a href="{% url 'book:list' %}">图书列表页面</a>

    如果url反转的时候需要传递参数,那么可以通过位置参数和关键字参数两种方式,注意位置参数和关键字参数不能同时使用,例如:

    #urls.py模块中 path('detail/<book_id>/',views.book_detail,name='detail') #模板文件中 #url反转,使用位置参数 <a href="{% url 'book:detail' 1 %}">图书详情页面</a> #url反转,使用关键字参数 <a href="{% url 'book:detail' book_id=1 %}">图书详情页面</a>

    如果需要传递多个参数,那么通过空格的方式进行分隔,例如:

    <a href="{% url 'book:detail' book_id=1 page=2 %}">图书详情页面</a>

    如果想要在url标签反转时传递查询字符串的参数,那么必须要手动在在后面添加,例如:

    <a href="{% url 'book:detail' book_id=1 %}?page=1">图书详情页面</a>

    spaceless标签

    该标签用于移除html标签中的空白字符,包括空格、tab键、换行等,例如:

    {% spaceless %} <p> <a href="foo/">Foo</a> </p> {% endspaceless %}

    渲染完成后,页面中的代码会变成下面这样:

    <p><a href="foo/">Foo</a></p>

    spaceless只会移除html标签之间的空白字符,而不会移除标签与文本之间的空白字符,例子:

    {% spaceless %} <strong> Hello </strong> {% endspaceless %}

    上述代码将不会移除strong标签中的空白字符。

    autoescape标签

    该标签可以开启和关闭这个标签内元素的自动转义功能,自动转义可以将一些特殊的字符,比如<转义成html语法能识别的字符,比如<会被转义成<,而>会被自动转义成>,模板中默认是已经开启了自动转义的,例如:

    #传递的上下文信息 context = { "info":"<a href='www.baidu.com'>百度</a>" } #模板中关闭自动转义 {% autoescape on %} {{ info }} {% endautoescape %}

    上述代码中,会显示百度的一个超链接,但是如果开启自动转义(off),那么就会显示成一个普通的字符串。

    verbatim标签

    在DTL模板中,默认会解析一些特殊字符,比如,{%和%}以及{{等。如果我们在某个代码片段中不想使用DTL的解析引擎,那么可以把这个代码片段放在verbatim标签中,例如:

    {% verbatim %} {{if dying}}Still alive.{{/if}} {% endverbatim %}
    Processed: 0.009, SQL: 9