Django模板语言

官方文档

常用的语法

在DjangoHong Kong只需要记两种特殊符号:

  1. {{ }}:变量相关
  2. {% %}: 逻辑相关

变量

在Django模板语言中使用:{{变量名}}.
当模板引擎遇到一个变量它将计算这个变量，然后用结果替换掉它本身。 变量的命名包括任何字母数字以及下划线 ("_")的组合。 变量名称中不能有空格或标点符号。

点（.）在模板语言中有特殊的含义。当模版系统遇到点(".")，它将以这样的顺序查询

字典查询（Dictionary lookup）
属性或方法查询（Attribute or method lookup）
数字索引查询（Numeric index lookup）

注意
1.如果计算结果的值是可调用的，它将被无参数的调用。 调用的结果将成为模版的值。

  1. 如果使用的变量不存在， 模版系统将插入 string_if_invalid 选项的值， 它被默认设置为'' (空字符串) 。
    例子
    view.py里的代码
from django.shortcuts import render

# Create your views here.

def t(request):
    d1 = {'name':'xxs','age':19,'items':'hhh'}

    class Person:
        def __init__(self,name,age):
            self.name = name
            self.age = age
        @staticmethod
        def dream():
            return 'hello word'
    xyh = Person('xyh',30)

    list1 = ['dq','ffe','dsf','gre','wer']
    p1 = Person('yhl',18)
    p2 = Person('hsh',78)
    p3 = Person('ww',68)
    list2 = [p1,p2,p3]
    return render(request,'t.html',{'name':'xxx','age':23,'d1':d1,'sb':xyh,'li':list1,'list2':list2})

HTML

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Django模板语言</title>
</head>
<body>
    <p>{{ name }}</p>
    <p>{{ age }}</p>
    <hr>
    <h3>字典按key取值</h3>
    <p>{{ d1.name }}</p>
    <p>{{ d1.age }}</p>
    <h3>属性或key和方法重名优先显示属性或KEY</h3>
    <p>{{ d1.items }}</p>
    <hr>
    <h3>对象.属性</h3>
    <p>{{ sb.name }}</p>
    <p>{{ sb.age }}</p>
    <h3>对象.方法 不用加括号</h3>
    <p>{{ sb.dream }}</p>
    <hr>
    <h3>列表按索引取值</h3>
    <p>{{ li.2 }}</p>
    <hr>
    <h3>支持链式操作</h3>
    <p>{{ list2.1.name }}</p>
    <p>{{ list2.1.age }}</p>
</body>
</html>

结果:


页面显示结果.png

Filters(过滤器)

在Django的模板语言中，通过使用 过滤器 来改变变量的显示。
语法:{{ value|filter_name:参数 }}
参数

  • value是变量名
  • |是管道符
  • filter_name:参数是过滤器名和参数例:{{ name|lower }}会将name变量应用lower过滤器之后再显示它的值。lower在这里的作用是将文本全都变成小写。

注意
1.过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
2.过滤器可以接受参数，例如：{{ sss|truncatewords:30 }}，这将显示sss的前30个词。
3.过滤器参数包含空格的话，必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素，如：{{ list|join:', ' }}
4.'|'左右没有空格没有空格没有空格

常用的内置过滤器

我们先在view.py文件里边写好要传的内容:

from django.shortcuts import render
from datetime import datetime,timedelta
def t2(request):
    name = 'xyh'
    file_size = 4325435346432
    now = datetime.now() # 获取一个datatime类型的时间
    a = '<a href="heeps://www.4399.com">4399</a>'
    p = '''
    只有经历过地狱般的磨砺，才能练就创造天堂的力量；
    只有流过血的手指，才能弹出世间的绝响。
    只有经历过地狱般的磨砺，才能练就创造天堂的力量；
    只有流过血的手指，才能弹出世间的绝响。
    纵然伤心，也不要愁眉不展，因为你不知是谁会爱上你的笑容。
    '''
    p2 = 'aledfaaalfd'
    list = ['dq','ffe','dsf','gre','wer']

    # 获取5小时之前的时间
    l = now - timedelta(hours=5)
    return render(request,
                  't2.html',
                  {
                      'name':name,
                      'file_size':file_size,
                      'now':now,
                      'a':a,
                      'p': p,
                      'p2': p2,
                      'list':list,
                      'l' : l
                  }
    )

default

如果一个变量是false或者为空，使用给定的默认值。 否则，使用变量的值。
如果value没有传值或者值为空的话就显示nothing
{{ value|default:"默认值"}}

HTML.png

结果:
页面显示.png

length

返回值的长度，作用于字符串和列表。
{{ value|length} }

HTML.png

结果:
页面显示.png

filesizeformat

将值格式化为一个 “人类可读的” 文件尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等）。例如：
{{ value|filesizeformat }}

HTML.png

结果:


网页显示.png

slice

切片
{{value|slice:"2:-1"}}

HTML.png

结果:
网页显示.png

data

时间格式化
{{ value|date:"Y-m-d H:i:s"}}
可用的参数:

格式化字符 描述 示例输出
a 'a.m.'或'p.m.'（请注意，这与PHP的输出略有不同，因为这包括符合Associated Press风格的期间） 'a.m.'
A 'AM'或'PM'。 'AM'
b 月，文字，3个字母，小写。 'jan'
B 未实现。
c ISO 8601格式。 （注意：与其他格式化程序不同，例如“Z”，“O”或“r”，如果值为naive datetime，则“c”格式化程序不会添加时区偏移量（请参阅datetime.tzinfo） 。 2008-01-02T10:30:00.000123+02:00或2008-01-02T10:30:00.000123如果datetime是天真的
d 月的日子，带前导零的2位数字。 '01'到'31'
D 一周中的文字，3个字母。 “星期五”
e 时区名称 可能是任何格式，或者可能返回一个空字符串，具体取决于datetime。 ''、'GMT'、'-500'、'US/Eastern'等
E 月份，特定地区的替代表示通常用于长日期表示。 'listopada'（对于波兰语区域，而不是'Listopad'）
f 时间，在12小时的小时和分钟内，如果它们为零，则分钟停留。 专有扩展。 '1'，'1:30'
F 月，文，长。 '一月'
g 小时，12小时格式，无前导零。 '1'到'12'
G 小时，24小时格式，无前导零。 '0'到'23'
h 小时，12小时格式。 '01'到'12'
H 小时，24小时格式。 '00'到'23'
i 分钟。 '00'到'59'
I 夏令时间，无论是否生效。 '1'或'0'
j 没有前导零的月份的日子。 '1'到'31'
l 星期几，文字长。 '星期五'
L 布尔值是否是一个闰年。 True或False
m 月，2位数字带前导零。 '01'到'12'
M 月，文字，3个字母。 “扬”
n 月无前导零。 '1'到'12'
N 美联社风格的月份缩写。 专有扩展。 'Jan.'，'Feb.'，'March'，'May'
o ISO-8601周编号，对应于使用闰年的ISO-8601周数（W）。 对于更常见的年份格式，请参见Y。 '1999年'
O 与格林威治时间的差异在几小时内。 '+0200'
P 时间为12小时，分钟和'a.m。'/'p.m。'，如果为零，分钟停留，特殊情况下的字符串“午夜”和“中午”。 专有扩展。 '1 am'，'1:30 pm' / t3>，'midnight'，'noon'，'12：30 pm' / T10>``
r RFC 5322格式化日期。 'Thu, 21 Dec 2000 16:01:07 +0200'
s 秒，带前导零的2位数字。 '00'到'59'
S 一个月的英文序数后缀，2个字符。 'st'，'nd'，'rd'或'th'
t 给定月份的天数。 28 to 31
T 本机的时区。 'EST'，'MDT'
u 微秒。 000000 to 999999
U 自Unix Epoch以来的二分之一（1970年1月1日00:00:00 UTC）。
w 星期几，数字无前导零。 '0'（星期日）至'6'（星期六）
W ISO-8601周数，周数从星期一开始。 1，53
y 年份，2位数字。 '99'
Y 年，4位数。 '1999年'
z 一年中的日子 0到365
Z 时区偏移量，单位为秒。UTC以西时区的偏移量总是为负数，对于UTC以东时，它们总是为正。 -43200到43200
HTML.png

结果:


网页显示.png

safe

Django的模板中会对HTML标签和JS等语法标签进行自动转义，原因显而易见，这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义，比如我们做一个内容管理系统，后台添加的文章中是经过修饰的，这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本，如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式，如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。
{{ value|safe}}

HTML.png

结果:
网页显示.png

truncatechars和truncatewords

如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾。

参数：截断的字符数
{{ value|truncatechars:9}}
在一定数量的字后截断字符串。
{{ value|truncatewords:9}}

HTML.png

结果:


HTML.png

cut

移除value中所有的与给出的变量相同的字符串
{{ value|cut:' ' }}

HTML.png

结果:


网页显示.png

join

使用字符串连接列表，例如Python的str.join(list)


HTML.png

结果:


网页显示.png

timesince

将日期格式设为自该日期起的时间（例如，“4天，6小时”）。

采用一个可选参数，它是一个包含用作比较点的日期的变量（不带参数，比较点为现在）。 例如，如果blog_date是表示2006年6月1日午夜的日期实例，并且comment_date是2006年6月1日08:00的日期实例，则以下将返回“8小时”：
{{ blog_date|timesince:comment_date }}
分钟是所使用的最小单位，对于相对于比较点的未来的任何日期，将返回“0分钟”。

HTML.png

结果:
网页显示.png

自定义filter

自定义过滤器只是带有一个或两个参数的Python函数:

  • 变量（输入）的值 - -不一定是一个字符串
  • 参数的值 - 这可以有一个默认值，或完全省略
    自定义步骤

  1. 在app下面新建一个python package名字叫templatetags


    创建templatetags包

  2. 在上一步的python package中新建一个py文件


    创建py文件

  3. 在py文件中写一个函数，实现自定义的filter功能

def sb(value):
    return value + 'sb'
  1. 告诉Django我现在多了一个自定义的filter
from django import template
register = template.Library()

@register.filter()
def sb(value):
    return value + 'sb'

使用步骤

  1. 在HTML文件中导入刚才创建的py文件


    导入文件
{% load s1 %}
  1. 重启Django项目
  2. 按照普通的filter调用自定义的函数

Tags

for循环

普通for循环

<ul>
{% for user in user_list %}
    <li>{{ user.name }}</li>
{% endfor %}
</ul>

for循环可用的一些参数：

Variable Description
forloop.counter 当前循环的索引值（从1开始）
forloop.counter0 当前循环的索引值（从0开始）
forloop.revcounter 当前循环的倒序索引值（从1开始）
forloop.revcounter0 当前循环的倒序索引值（从0开始）
forloop.first 当前循环是不是第一次循环（布尔值）
forloop.last 当前循环是不是最后一次循环（布尔值）
forloop.parentloop 本层循环的外层循环

for ... empty

<ul>
{% for user in user_list %}
    <li>{{ user.name }}</li>
{% empty %}
    <li>空空如也</li>
{% endfor %}
</ul>

if判断

if,elif和else

{% if user_list %}
  用户人数：{{ user_list|length }}
{% elif black_list %}
  黑名单数：{{ black_list|length }}
{% else %}
  没有用户
{% endif %}

当然也可以只有if和else

{% if user_list|length > 5 %}
  七座豪华SUV
{% else %}
    黄包车
{% endif %}

if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断.

with

定义一个中间变量，多用于给一个复杂的变量起别名。

注意等号左右不要加空格。

{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

或

{% with business.employees.count as total %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

csrf_token

这个标签用于跨站请求伪造保护。
在页面的form表单里面写上{% csrf_token %}

注释

{# ... #}

注意事项

  1. Django的模板语言不支持连续判断，即不支持以下写法：
{% if a > b > c %}
...
{% endif %}
  1. Django的模板语言中属性的优先级大于方法
def xx(request):
    d = {"a": 1, "b": 2, "c": 3, "items": "100"}
    return render(request, "xx.html", {"data": d})

如上，我们在使用render方法渲染一个页面的时候，传的字典d有一个key是items并且还有默认的 d.items() 方法，此时在模板语言中:

{{ data.items }}

默认会取d的items key的值

自定义Tag

和自定义filter类似,创建的步骤也一样(如何创建和应用参考自定义filter),但是tag更灵活

simple_tag

  1. 处理复杂逻辑的自定义功能
  2. 写法同自定义filter类似

自定义方法:

from django import template
register = template.Library()  # 生成一个注册的实例对象
@register.simple_tag(name="自定义名字(可以不写)")  # 定义注册simple_tag
def 函数名(参数):
    return 结果

使用:

{% load .py文件名%}
{%自定义Tag名字 参数  %}

例:

from django import template
register = template.Library()  # 生成一个注册的实例对象
@register.simple_tag()
def se(arg1,arg2):
    return arg1 + arg2

<h3>自定义的simple_tag示例</h3>
    {% load s1 %}
    <p>{% se 2 4 %}</p>

结果:


结果

inclusion_tag
多用于返回html代码片段
示例：

templatetags/my_inclusion.py

from django import template

register = template.Library()


@register.inclusion_tag('result.html')
def show_results(n):
    n = 1 if n < 1 else int(n)
    data = ["第{}项".format(i) for i in range(1, n+1)]
    return {"data": data}

templates/snippets/result.html

<ul>
  {% for choice in data %}
    <li>{{ choice }}</li>
  {% endfor %}
</ul>

templates/index.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="x-ua-compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>inclusion_tag test</title>
</head>
<body>

{% load inclusion_tag_test %}

{% show_results 10 %}
</body>
</html>

母版

什么情况下用母版?
当多个页面的大部分内容都一样的时候，我们可以把相同的部分提取出来，放到一个单独的母版文件中
使用

  1. 在母版中定义需要被替换的block
{% block page-main %}

{% endblock %}
  1. 在子页面中
    1. 先继承母版 --> {% extends '母版.html' %}
    2. 定义block
{% block page-main %}
...
{% endblock page-main %}
  1. 通常的用法
    1. {% bloack page-css %} {% endblock %}
    2. {% block page-js %} {% endblock %}

母版结构

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="x-ua-compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Title</title>
  {% block page-css %}
  
  {% endblock %}
</head>
<body>

<h1>这是母板的标题</h1>

{% block page-main %}

{% endblock %}
<h1>母板底部内容</h1>
{% block page-js %}

{% endblock %}
</body>
</html>

注意：

我们通常会在母板中定义页面专用的CSS块和JS块，方便子页面替换。

组件

  1. 什么时候用组件？

页面上相对独立的某个部分可以单独拿出来放到一个单独的html文件中

  1. 如何使用？
    {% inclued '组件.html' %}
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 194,457评论 5赞 459
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 81,837评论 2赞 371
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 141,696评论 0赞 319
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 52,183评论 1赞 263
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 61,057评论 4赞 355
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 46,105评论 1赞 272
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 36,520评论 3赞 381
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 35,211评论 0赞 253
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 39,482评论 1赞 290
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,574评论 2赞 309
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,353评论 1赞 326
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,213评论 3赞 312
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 37,576评论 3赞 298
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,897评论 0赞 17
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1赞 250
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 41,489评论 2赞 341
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 40,683评论 2赞 335

推荐阅读更多精彩内容

  • Django 模板语言（译）
    声明：转载请注明出处http://www.jianshu.com/p/1664dcfd840c 最近在折腾Djan...
    蛇发女妖阅读 6,247评论 1赞 10
  • Django模板语言
    知识点： 代码布局 编写自定义模板过滤器 简单标签 包含标签 分配标签 静态文件加载 为了解决应用中展示逻辑的需求...
    LinearPi阅读 504评论 0赞 0
  • django养生
    模块间联系越多，其耦合性越强，同时表明其独立性越差( 降低耦合性，可以提高其独立性)。软件设计中通常用耦合度和内聚...
    riverstation阅读 2,054评论 0赞 8
  • django模板语言
    一般情况下后台提取到数据时候只会以某种数据类型的方式交给HTML页面，如果所有的都编程单个的变量，会严重影响开发效...
    戴维得阅读 465评论 0赞 0
  • 失恋妄想症
    如果没有表白，生活会不会一切如常照旧？如果彼此喜欢，会不会童话一个？ 昨天傍晚，夕阳未尽。在一棵枝...
    QIYU098阅读 679评论 12赞 21