小白必看!Django 模板语言基础来啦

作者 | 单雨

责编 | 胡巍巍

出品 | CSDN(ID:CSDNnews)

前言

为了实现模板封装和复用,提高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 %}

{{ section.title }}

{% for story in story_list %}

{{ story.headline|upper }}

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

{% endfor %}

{% endblock %}

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

基础语法

变量

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

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

示例:

django

My firstnameis{{ first_name }}. My lastnameis{{ last_name }}.

当传入一个上下文字典`{'first_name': 'John', 'last_name': 'Doe'}`时,将会渲染得到:

django

My firstnameisJohn. My lastnameisDoe.

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

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

django

{{ my_dict.key }}

{{ my_object.attribute }}

{{ my_list.0 }}

点表示法底层原理

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

1. 字典查询

2. 属性或方法查找

3. 数字索引查询

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

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

django

{%fork, vindefaultdict.items %}

{% endfor %}

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

注意

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

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

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

标签

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

(1)标签声明

标签的一般形式为:

django

{% tag %}

示例:

django

{% csrf_token %}

(2)传入参数

django

{% cycle'odd''even'%}

(3)成对使用的标签

有些标签需要开始和结束标签:

django

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

(4)常用标签

for:循环数组中的每个元素. 比如, 显示列表 `athlete_list` 中每个元素的 `name` 属性。

django

{% for athlete in athlete_list %}

{{ athlete.name }}

{% endfor %}

if 、elif和else:在上面,如果athlete_list不为空,则{}变量将显示运动员的数量。

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

也可以在if标签里使用过滤器和各种操作符:

django

{%ifathlete_list|length >1%}

Team: {%forathlete in athlete_list %} ... {%endfor%}

{%else%}

Athlete: {{ athlete_list.0.name }}

{%endif%}

注意

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

(5)更多

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20190919A05WDC00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券