为了实现模板封装和复用,提高HTML界面调试便捷性以及前后端解耦等目标,Django定义了自己的网络模板语言。当前介绍模板语言的官方文档已经非常完备,几乎涵盖了开发中需要用到的知识点和需要注意的问题,但同时官方文档也存在一些问题:- 一些知识点的介绍过于简短,存在大量的页内链接,阅读时需要跳转到不同的页面,阅读不连贯。
本文基于官方文档系统介绍了Django模板语言的基础知识点,方便快速了解Django模板语言。Django的模板系统不是简单的把Python嵌入到HTML中。 它的设计宗旨是:模板系统旨在展示内容, 而不是程序逻辑,因此不在HTML页面中嵌入Python。简单的说,模板只负责渲染数据,大多数逻辑应该交给视图(view)进行处理。模板是一个简单的文本文件。它可以生成任何基于文本的格式(如 HTML,XML,CSV等)。除了基本的HTML标签外,模板还包含两种额外的元素——变量和标签。模板中包含的变量可以被替换为变量的值,标签则被替换为相应的模板控制逻辑。示例:django
{% extends "base_generic.html" %}
{% block title %}{{ section.title }}{% endblock %}
{% block content %}
<h1>{{ section.title }}</h1>
{% for story in story_list %}
<h2>
<a href="{{ story.get_absolute_url }}">
{{ story.headline|upper }}
</a>
</h2>
<p>{{ story.tease|truncatewords:"100" }}</p>
{% endfor %}
{% endblock %}
`{{ section.title }}`在模板渲染时将会被变量的值替换,for标签可以实现模板的循环渲染。变量实现从模板上下文字典(返回HTTP响应时传递过来的字典)中输出一个值,这是一个类似于dict的对象,包含键值对。当模板引擎遇到一个变量时,它会计算该变量,并用结果替换它。变量名由字母、数字字符和下划线("_")组成,但不能以下划线开头。点(".")也出现在变量中,代表属性调用,变量名中不能有空格或标点符号。django My first name is {{ first_name }}. My last name is {{ last_name }}.
当传入一个上下文字典`{first_name: John, last_name: Doe}`时,将会渲染得到:django My first name is John. My last name is Doe.
变量还可以使用点表示法实现字典查找、属性查找和列表索引查找等操作:django {{ my_dict.key }} {{ my_object.attribute }} {{ my_list.0 }}
如果结果值是可调用的,则调用该值时将不带参数,调用的结果成为新的模板值。当进行能覆盖字典查找的操作时,这种查找顺序可能会造成一些意想不到的行为。例如:如果试图循环一个collection .defaultdict字典对象:django
{% for k, v in defaultdict.items %}
{其他操作}
{% endfor %}
因为字典查找是首先发生的,所以这个行为会先提供一个默认值,而不是使用预期的.items()方法。在这种情况下,应该首先考虑使用字典查找,而不是使用字典的属性调用。属性通常被解释为一个文本字符串,防止和同名的变量冲突。例如{{foo.bar}}中的属性“bar”将被解释为一个文本字符串,如果模板上下文中存在变量“bar”,则不会使用该变量的值。以下划线开头的变量属性可能不能访问,因为它们通常被认为是私有的。如果引用不存在的变量,模板系统将插入string_if_invalid选项的值,该选项默认设置为“”(空字符串)。标签在模板渲染过程中提供任意逻辑。标签可以输出内容,作为控制结构,例如“if”语句或“for”循环,从数据库获取内容,甚至允许访问其他模板标签。django
{% cycle odd even %}
django
{% if user.is_authenticated %}Hello, {{ user.username }}.{% endif %}
for:循环数组中的每个元素. 比如, 显示列表 `athlete_list` 中每个元素的 `name` 属性。django
<ul>
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% endfor %}
</ul>
if 、elif和else:在上面,如果athlete_list不为空,则{{athlete_list|length}}变量将显示运动员的数量。否则,如果athlete_in_locker_room_list不为空,则会显示“Athletes should be out…”消息。如果两个列表都为空,则显示“No athletes”。django
{% if athlete_list|length > 1 %}
Team: {% for athlete in athlete_list %} ... {% endfor %}
{% else %}
Athlete: {{ athlete_list.0.name }}
{% endif %}
虽然上面的示例可以工作,但是要注意,大多数模板过滤器都返回字符串,因此使用过滤器进行数学比较通常不会正常工作,而长度是个例外。Django有很多内置标签,更多关于内置标签的信息请参考官方文档:https://docs./zh-hans/2.2/ref/templates/builtins/ref-templates-builtins-tagshttps://docs./zh-hans/2.2/howto/custom-template-tags/howto-writing-custom-template-tags如果需要对使用的标签和自定义的标签做一份说明文档,可以使用Django提供的文档工具,详情请参考:https://docs./zh-hans/2.2/ref/contrib/admin/admindocs/过滤器可以对变量做一些操作,例如给变量赋值,改变变量的值等。通过过滤器lower变量{{ name }}变为了小写字符,通过管道符(|)间隔变量和过滤器来使用过滤器。 {{ text|escape|linebreaks }}是一种常用的转换方式, 在这之后换行符被替换为了 <p> 标签。传入`{django: the web framework for perfecalist With deadline }`上下文字典时,该模板呈现为:django
The Web Framework For Perfectionists With Deadlines
django
{{ my_date|date:"Y-m-d" }}
django
{{ bio|truncatewords:30 }}
过滤器参数中如果包含空格和标点符号,必须使用引号“”括起来,例如,要用逗号和空格连接列表,可以使用{{list|join:", "}}。Django提供了大约60个内置模板过滤器,请参考官方文档:https://docs./zh-hans/2.2/ref/templates/builtins/ref-templates-builtins-filters,如果变量为false或空,则使用给定的默认值。否则,使用变量的值。例如:django
{{ value|default:"nothing" }}
如果 `value` 没有提供或者为空,那么将它显示为 "`nothing`" 。django
{{ value|length }}
如果 `value` 为 `[a, b, c, d]`, 那么他将被显示为 `4`。将值格式化为“人类可读的”文件大小(即“13kb”、“4.1 MB”、“102字节”等)。例如:django
{{ value|filesizeformat }}
如果值为123456789,则输出为117.7 MB。https://docs./zh-hans/2.2/howto/custom-template-tags/django
{ this wont be rendered }
多行注释:{% comment %} 和{% endcomment %}django
<p>Rendered text with {{ pub_date|date:"c" }}</p>
{% comment "Optional note" %}
<p>Commented out text with {{ create_date|date:"c" }}</p>
{% endcomment %} 作者简介:单雨,90后工科男,伪文艺青年。目前就读于北京理工大学宇航系,喜欢研究AI,网络爬虫,微信小程序以及机器人,痴迷于Coding,睡前必撸码。
|