作者 | 单雨

责编 | 胡巍巍

出品 | CSDN&＃xff08;ID&＃xff1a;CSDNnews&＃xff09;

 

前言

 

为了实现模板封装和复用&＃xff0c;提高HTML界面调试便捷性以及前后端解耦等目标&＃xff0c;Django定义了自己的网络模板语言。

当前介绍模板语言的官方文档已经非常完备&＃xff0c;几乎涵盖了开发中需要用到的知识点和需要注意的问题&＃xff0c;但同时官方文档也存在一些问题&＃xff1a;

• 翻译不够完善&＃xff0c;带来阅读的困难&＃xff1b;

• 一些知识点的介绍过于简短&＃xff0c;存在大量的页内链接&＃xff0c;阅读时需要跳转到不同的页面&＃xff0c;阅读不连贯。

本文基于官方文档系统介绍了Django模板语言的基础知识点&＃xff0c;方便快速了解Django模板语言。

 

模板系统设计哲学

 

Django的模板系统不是简单的把Python嵌入到HTML中。 

它的设计宗旨是&＃xff1a;模板系统旨在展示内容, 而不是程序逻辑&＃xff0c;因此不在HTML页面中嵌入Python。

简单的说&＃xff0c;模板只负责渲染数据&＃xff0c;大多数逻辑应该交给视图&＃xff08;view&＃xff09;进行处理。

 

模板简介

 

模板是一个简单的文本文件。它可以生成任何基于文本的格式&＃xff08;如 HTML,XML,CSV等&＃xff09;。除了基本的HTML标签外&＃xff0c;模板还包含两种额外的元素——变量和标签。

模板中包含的变量可以被替换为变量的值&＃xff0c;标签则被替换为相应的模板控制逻辑。示例&＃xff1a;

django

{% extends "base_generic.html" %}



{% block title %}{{ section.title }}{% endblock %}



{% block content %}

{{ section.title }}

{% for story in story_list %}

  

    {{ story.headline|upper }}

  

{{ story.tease|truncatewords:"100" }}

{% endfor %}

{% endblock %}

&＃96;{{ section.title }}&＃96;在模板渲染时将会被变量的值替换&＃xff0c;for标签可以实现模板的循环渲染。

 

基础语法

 

变量

变量实现从模板上下文字典&＃xff08;返回HTTP响应时传递过来的字典&＃xff09;中输出一个值&＃xff0c;这是一个类似于dict的对象&＃xff0c;包含键值对。当模板引擎遇到一个变量时&＃xff0c;它会计算该变量&＃xff0c;并用结果替换它。

变量名由字母、数字字符和下划线("_")组成&＃xff0c;但不能以下划线开头。点(".")也出现在变量中&＃xff0c;代表属性调用&＃xff0c;变量名中不能有空格或标点符号。

示例&＃xff1a;

django

My first name is {{ first_name }}. My last name is {{ last_name }}.

当传入一个上下文字典&＃96;{&＃39;first_name&＃39;: &＃39;John&＃39;, &＃39;last_name&＃39;: &＃39;Doe&＃39;}&＃96;时&＃xff0c;将会渲染得到&＃xff1a;

django

My first name is John. My last name is Doe.

模板中的变量被字典中的值替换了。

变量还可以使用点表示法实现字典查找、属性查找和列表索引查找等操作&＃xff1a;

django

{{ my_dict.key }}

{{ my_object.attribute }}

{{ my_list.0 }}

点表示法底层原理

当模板系统遇到一个点,它会按顺序尝试下面的动作&＃xff1a;

1. 字典查询

2. 属性或方法查找

3. 数字索引查询

如果结果值是可调用的&＃xff0c;则调用该值时将不带参数&＃xff0c;调用的结果成为新的模板值。

当进行能覆盖字典查找的操作时&＃xff0c;这种查找顺序可能会造成一些意想不到的行为。例如&＃xff1a;如果试图循环一个collection .defaultdict字典对象&＃xff1a;

 

django

{% for k, v in defaultdict.items %}

    {其他操作}

{% endfor %}

因为字典查找是首先发生的&＃xff0c;所以这个行为会先提供一个默认值&＃xff0c;而不是使用预期的.items()方法。在这种情况下&＃xff0c;应该首先考虑使用字典查找&＃xff0c;而不是使用字典的属性调用。

注意

属性通常被解释为一个文本字符串&＃xff0c;防止和同名的变量冲突。例如{{foo.bar}}中的属性“bar”将被解释为一个文本字符串&＃xff0c;如果模板上下文中存在变量“bar”&＃xff0c;则不会使用该变量的值。

以下划线开头的变量属性可能不能访问&＃xff0c;因为它们通常被认为是私有的。

如果引用不存在的变量&＃xff0c;模板系统将插入string_if_invalid选项的值&＃xff0c;该选项默认设置为“”(空字符串)。

标签

标签在模板渲染过程中提供任意逻辑。标签可以输出内容&＃xff0c;作为控制结构&＃xff0c;例如“if”语句或“for”循环&＃xff0c;从数据库获取内容&＃xff0c;甚至允许访问其他模板标签。

&＃xff08;1&＃xff09;标签声明

标签的一般形式为&＃xff1a;

 

django

{% tag %}

示例&＃xff1a;

django

{% csrf_token %}

&＃xff08;2&＃xff09;传入参数

django

{% cycle &＃39;odd&＃39; &＃39;even&＃39; %}

&＃xff08;3&＃xff09;成对使用的标签

有些标签需要开始和结束标签&＃xff1a;

django

{% if user.is_authenticated %}Hello, {{ user.username }}.{% endif %}

&＃xff08;4&＃xff09;常用标签

for&＃xff1a;循环数组中的每个元素.  比如, 显示列表 &＃96;athlete_list&＃96; 中每个元素的 &＃96;name&＃96; 属性。

django

  

  {% for athlete in athlete_list %}

      
• {{ athlete.name }}


  {% endfor %}

  

if 、elif和else&＃xff1a;在上面&＃xff0c;如果athlete_list不为空&＃xff0c;则{{athlete_list|length}}变量将显示运动员的数量。

否则&＃xff0c;如果athlete_in_locker_room_list不为空&＃xff0c;则会显示“Athletes should be out…”消息。如果两个列表都为空&＃xff0c;则显示“No athletes”。

也可以在if标签里使用过滤器和各种操作符&＃xff1a;

django

  {% if athlete_list|length > 1 %}

     Team: {% for athlete in athlete_list %} ... {% endfor %}

  {% else %}

     Athlete: {{ athlete_list.0.name }}

  {% endif %}

注意

虽然上面的示例可以工作&＃xff0c;但是要注意&＃xff0c;大多数模板过滤器都返回字符串&＃xff0c;因此使用过滤器进行数学比较通常不会正常工作&＃xff0c;而长度是个例外。

&＃xff08;5&＃xff09;更多

Django有很多内置标签&＃xff0c;更多关于内置标签的信息请参考官方文档&＃xff1a;

https://docs.djangoproject.com/zh-hans/2.2/ref/templates/builtins/ref-templates-builtins-tags

如果需要编写自定义标签&＃xff0c;请参考官方文档

https://docs.djangoproject.com/zh-hans/2.2/howto/custom-template-tags/howto-writing-custom-template-tags

如果需要对使用的标签和自定义的标签做一份说明文档&＃xff0c;可以使用Django提供的文档工具&＃xff0c;详情请参考&＃xff1a;

https://docs.djangoproject.com/zh-hans/2.2/ref/contrib/admin/admindocs/

 

过滤器

 

简介

过滤器可以对变量做一些操作&＃xff0c;例如给变量赋值&＃xff0c;改变变量的值等。

修改变量显示

过滤器可以修改变量的显示。例如&＃xff1a;

django

 {{ name|lower }} 

通过过滤器lower变量{{ name }}变为了小写字符&＃xff0c;通过管道符(|)间隔变量和过滤器来使用过滤器。

链式调用过滤器

一个过滤器的输出可以作为下一个过滤器的输入。

 {{ text|escape|linebreaks }}是一种常用的转换方式, 在这之后换行符被替换为了

标签。

转换变量和标签参数

过滤器转换变量和标签参数的值。示例&＃xff1a;

django

{{ django|title }}

传入&＃96;{&＃39;django&＃39;: &＃39;the web framework for perfecalist With deadline &＃39;}&＃96;上下文字典时&＃xff0c;该模板呈现为&＃xff1a;

django

The Web Framework For Perfectionists With Deadlines

传入参数给过滤器

示例1&＃xff1a;

django

{{ my_date|date:"Y-m-d" }}

my_date将会被替换为当前日期。

示例2&＃xff1a;

django 

{{ bio|truncatewords:30 }}

将会会显示 &＃96;bio&＃96; 变量的前30个字符

注意

过滤器参数中如果包含空格和标点符号&＃xff0c;必须使用引号“”括起来&＃xff0c;例如&＃xff0c;要用逗号和空格连接列表&＃xff0c;可以使用{{list|join:"&＃xff0c; "}}。

Django提供了大约60个内置模板过滤器&＃xff0c;请参考官方文档&＃xff1a;

https://docs.djangoproject.com/zh-hans/2.2/ref/templates/builtins/ref-templates-builtins-filters&＃xff0c;

下面列举一些常用的过滤器&＃xff1a;

default

如果变量为false或空&＃xff0c;则使用给定的默认值。否则&＃xff0c;使用变量的值。例如&＃xff1a;

django

  {{ value|default:"nothing" }}

如果 &＃96;value&＃96; 没有提供或者为空&＃xff0c;那么将它显示为 "&＃96;nothing&＃96;" 。

length

返回值的长度。这对字符串和列表都适用。例如&＃xff1a;

django

  {{ value|length }}

如果 &＃96;value&＃96; 为 &＃96;[&＃39;a&＃39;, &＃39;b&＃39;, &＃39;c&＃39;, &＃39;d&＃39;]&＃96;, 那么他将被显示为 &＃96;4&＃96;。

filesizeformat

将值格式化为“人类可读的”文件大小(即“13kb”、“4.1 MB”、“102字节”等)。例如&＃xff1a;

django

  {{ value|filesizeformat }}

如果值为123456789&＃xff0c;则输出为117.7 MB。

如果需要自定义过滤器&＃xff0c;请参考请官方文档&＃xff1a;

https://docs.djangoproject.com/zh-hans/2.2/howto/custom-template-tags/

 

注释

 

示例&＃xff1a;

单行注释

django

{ this won&＃39;t be rendered }

多行注释&＃xff1a;{% comment %} 和{% endcomment %}

django

Rendered text with {{ pub_date|date:"c" }}

{% comment "Optional note" %}

    

Commented out text with {{ create_date|date:"c" }}

{% endcomment %}

注意&＃xff1a;Comment标签不能嵌套使用。

作者简介&＃xff1a;单雨&＃xff0c;90后工科男&＃xff0c;伪文艺青年。目前就读于北京理工大学宇航系&＃xff0c;喜欢研究AI&＃xff0c;网络爬虫&＃xff0c;微信小程序以及机器人&＃xff0c;痴迷于Coding&＃xff0c;睡前必撸码。

【END】

Python 学习路线思维导图, 收藏!

https://edu.csdn.net/topic/python115?utm_source&＃61;csdn_bw

 热 文 推 荐 

☞

☞

☞

☞D

☞

☞

☞

☞

点击阅读原文&＃xff0c;即刻阅读《程序员大本营》最新期刊。

你点的每个“在看”&＃xff0c;我都认真当成了喜欢