六、Django之Template

作者：@skyflask
转载本文请注明出处：https://www.cnblogs.com/skyflask/p/9314529.html

目录

一、Template由来
二、Django中的template
1、定义模板引擎
2、渲染模板
3、Django中使用模板
4、万能的点号（.）
5、不合法的变量处理
6、Context对象
7、变量的过滤器
8、标签(tag)
9、自定义filter和simple_tag
10、模板继承
后记
一、变量

二、过滤器
三、标签 

一、Template由来

1、任何前端页面的改动都和后端有关；

2、前端HTML和后端python分开能让网站更加清晰；

3、前后端分离的趋势下，专业的事交给专业的人做。

 

二、Django中的template

1、定义模板引擎

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
TEMPLATES = [
    {
       #Django默认模板引擎，也可以设置jinja2模板
       #django.template.backends.jinja2.Jinja2
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
 
       #设置template位置
        'DIRS': [os.path.join(BASE_DIR, 'templates')]
 
        #告诉引擎是否需要查找内部app下的模板
        'APP_DIRS': True,
        #其他选项
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

　　

2、渲染模板

?
1
2
3
4
5
6
7
8
9
10
11
12
13
(venv) D:\xuequn\venv\Scripts\firstapp>python manage.py shell
Python 2.7.15 (v2.7.15:ca079a3ea3, Apr 30 2018, 16:30:26) [MSC v.1500 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
 
>>> from django.template import Template
>>> t=Template('my name is {{name}}.')
>>> print t
<django.template.base.Template object at 0x00000000038F9F60>
>>> from django.template import Context
>>> c=Context({'name':'xuequn'})
>>> t.render(c)
u'my name is xuequn.'

　　

其实模板选项和字符串format格式化类似，只不过django中使用render进行渲染。

>>> '{name} is {li}'.format(**{'name':'xuequn','li':'haha'})

 

3、Django中使用模板

Django 模板解析非常快捷。 大部分的解析工作都是在后台通过对简短正则表达式一次性调用来完成。 这和基于 XML 的模板引擎形成鲜明对比，那些引擎承担了 XML 解析器的开销，且往往比 Django 模板渲染引擎要慢上几个数量级。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
from django.shortcuts import render,HttpResponse
from django.template.loader import get_template #记得导入
import datetime
from django.template import Template,Context
 
 
# 视图方法1
def current_time(req):
    #原始的视图函数，通过传递字符串或者直接读取文件内容为字符串的方法
     now=datetime.datetime.now()
     html="<html><body>现在时刻：<h1>%s.</h1></body></html>" %now
     return HttpResponse(html)
 
 
#视图方法2
def current_time(req):     #使用Template、Context以及render方法进行动态内容渲染
     now=datetime.datetime.now()
     #t=Template('<html><body>现在时刻是:<h1 style="color:red">{{current_date}}</h1></body></html>')
     t=get_template('current_datetime.html')
     c=Context({'current_date':now})
     html=t.render(c)
     return HttpResponse(html)
 
#视图方法3(推荐)
def current_time(req):    #直接通过Django的render方法，将html内容以及变量传入即可。
    now=datetime.datetime.now()
    return render(req, 'current_datetime.html', {'current_date':now})

　　

4、万能的点号（.）

使用小数点来得到字典的key，属性，对象的索引和方法。

通过(.)访问字典的key：

?
1
2
3
4
5
6
>>> from django.template import Template, Context
>>> person = {'name': 'Sally', 'age': '43'}
>>> t = Template('{{ person.name }} is {{ person.age }} years old.')
>>> c= Context({'person': person})
>>> t.render(c)
'Sally is 43 years old.'

　　

通过(.)来访问对象的属性：

?
1
2
3
4
5
6
7
8
>>> from django.template import Template, Context
>>> import datetime
>>> d = datetime.date(1993, 5, 2)
>>> d.year
1993
>>> d.month
5
>>> d.day

　　

调用列表的索引：

?
1
2
3
4
5
>>> from django.template import Template, Context
>>> t = Template('Item 2 is {{ items.2 }}.')
>>> c = Contexst({'items': ['apples', 'bananas', 'carrots']})
>>> t.render(c)
'Item 2 is carrots.'

　　

点还可以用来访问对象的方法，例如Python的string有upper()和isdigit()方法：

?
1
2
3
4
5
6
>>> from django.template import Template, Context
>>> t = Template('{{ var }} -- {{var.upper }} -- {{ var.isdigit }}')
>>> t.render(Context({'var': 'hello'}))
'hello -- HELLO -- False'
>>> t.render(Context({'var': '123'}))
'123 - 123 - True'

　

注意，调用方法时你不能加括号，你也不能给方法传递参数
你只能调用没有参数的方法，后面我们会解释这些
总结一下，当模板系统遇到变量名里有小数点时会按以下顺序查找：
1，字典查找，如foo["bar"]
2，属性查找，如foo.bar
3，方法调用，如foo.bar()
3，列表的索引查找，如foo[bar]
小数点可以链式查询，例如{{ person.name.upper }}表示字典查询person['name']然后调用upper()方法。

 

5、不合法的变量处理

默认情况下如果变量不存在，模板系统会把它渲染成空string，例如：

?
1
2
3
4
5
6
7
8
9
10
>>> from django.template import Template, Context
>>> t = Template('Your name is {{ name }}.')
>>> t.render(Context())
'Your name is .'
>>> t.render(Context({'var': 'hello'}))
'Your name is .'
>>> t.render(Context({'NAME': 'hello'}))
'Your name is .'
>>> t.render(Context({'Name': 'hello'}))
'Your name is .'

　　

6、Context对象

大多数情况下你初始化Context对象会传递一个字典给Context()，一旦你初始化了Context，你可以使用标准Python字典语法增减Context对象的items：

?
1
2
3
4
5
6
7
8
9
10
>>> from django.template import Context
>>> c = Context({"foo": "bar"})
>>> c['foo']
'bar'
>>> del c['foo']
>>> c['foo']
''
>>> c['newvariable'] = 'hello'
>>> c['newvariable']
'hello'

　　

Context对象是一个stack，你可以push()和pop()
如果你pop()的太多的话它将触发django.template.ContextPopException：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
>>> c = Context()
>>> c['foo'] = 'first level'
>>> c.push()
>>> c['foo'] = 'second level'
>>> c['foo']
'second level'
>>> c.pop()
>>> c['foo']
'first level'
>>> c['foo'] = 'overwritten'
>>> c['foo']
'overwritten'
>>> c.pop()
Traceback (most recent call last):
...
django.template.ContextPopException

　　

7、变量的过滤器

模板过滤器是变量显示前转换它们的值的方式，看起来像下面这样：

?
1
{{ name|lower }}

　　更多实例：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# 1  add          ：   给变量加上相应的值
   #
   # 2  addslashes   :    给变量中的引号前加上斜线
   #
   # 3  capfirst     :    首字母大写
   #
   # 4  cut          ：   从字符串中移除指定的字符
   #
   # 5  date         ：   格式化日期字符串
   #
   # 6  default      ：   如果值是False,就替换成设置的默认值，否则就是用本来的值
   #
   # 7  default_if_none:  如果值是None，就替换成设置的默认值，否则就使用本来的值
 
 
#实例:
 
#value1="aBcDe"
{{ value1|upper }}<br>
 
#value2=5
{{ value2|add:3 }}<br>
 
#value3='he  llo wo r ld'
{{ value3|cut:' ' }}<br>
 
#import datetime
#value4=datetime.datetime.now()
{{ value4|date:'Y-m-d' }}<br>
 
#value5=[]
{{ value5|default:'空的' }}<br>
 
#value6='<a href="#">跳转</a>'
 
{{ value6 }}
 
{% autoescape off %}
  {{ value6 }}
{% endautoescape %}
 
{{ value6|safe }}<br>
 
{{ value6|striptags }}
 
#value7='1234'
{{ value7|filesizeformat }}<br>
{{ value7|first }}<br>
{{ value7|length }}<br>
{{ value7|slice:":-1" }}<br>
 
#value8='http://www.baidu.com/?a=1&b=3'
{{ value8|urlencode }}<br>

　　

8、标签(tag)

if

?
1
2
3
4
5
{% if %}
 
{% elif %}
 
{% else %}

　

for

?
1
2
3
{% for obj in list %}
    <li>{{ obj.name }}</li>
{% endfor %}

　for标签还有几个有用的内置变量：

1，forloop.counter表示循环的次数，它从1开始计数，第一次循环设为1:

    {% for item in todo_list %}
        <p>{{ forloop.counter }}: {{ item }}</p>
    {% endfor %}
2，forloop.counter0 类似于forloop.counter，但它是从0开始计数，第一次循环设为0
3，forloop.revcounter
4，forloop.revcounter0
5，forloop.first当第一次循环时值为True，在特别情况下很有用：

    
    {% for object in objects %}   
         {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}   
         {{ object }}   
        </li>  
    {% endfor %}

　

empty

?
1
2
3
4
5
{%  for i in li %}
        <li>{{ forloop.counter0 }}----{{ i }}</li>
    {% empty %}
        <li>this is empty!</li>
    {% endfor %}

　

csrf_token　

?
1
{%csrf_token%}：csrf_token标签

　　

url

?
1
{% url %}:  引用路由配置的地址

　　

with

用更简单的变量名替代复杂的变量名

?
1
{% with total=fhjsaldfhjsdfhlasdfhljsdal %} {{ total }} {% endwith %}

　　

verbatim

禁止render

?
1
2
3
{% verbatim %}
         {{ hello }}
{% endverbatim %}

　　

load 

加载标签库

?
1
{% load %}

　　

9、自定义filter和simple_tag

实现流程：

  • 在app中创建templatetags模块(必须的)
  • 创建任意 .py 文件，如：mytags.py
  • 在使用自定义simple_tag和filter的html文件中导入之前创建的 mytags.py ：{% load mytags %}
  • 使用simple_tag和filter（如何调用）
  • 在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.
  • filter可以用在if等语句后，simple_tag不可以
?
1
2
3
{% if num|filter_multi:30 > 100 %}
    {{ num|filter_multi:30 }}
{% endif %}

 

自定义标签分为很多类型

　　1  简单标签  Simple tags

　　2  内含标签  Inclusion tags

　　3  分配标签  Assignment tags

 

mytag.py

a、简单标签

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
from django import template
from django.utils.safestring import mark_safe
 
register = template.Library()   #register的名字是固定的,不可改变
 
#自定义filter
@register.filter
def filter_multi(v1,v2):
    return  v1 * v2
 
#simple_tag
@register.simple_tag
def simple_tag_multi(v1,v2):
    return  v1 * v2
 
 
@register.simple_tag
def my_input(id,arg):
    result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
    return mark_safe(result)

　　

调用

?
1
2
3
4
5
6
7
8
9
{% load mytag %}   #首行
    
 # num=12
{{ num|filter_multi:2 }} #24
 
{{ num|filter_multi:"[22,333,4444]" }}
 
{% simple_tag_multi 2 5 %}  参数不限,但不能放在if for语句中
{% simple_tag_multi num 5 %}

　　

 

b、内含标签

mytags.py

?
1
2
3
4
5
6
7
from django import template
register = template.Library()
 
@register.inclusion_tag('result.html')
def test():
    a=['first','second','third']
    return {'choices':a}

　　mytags的作用就是：将返回的结果，作为返回值传入html中，并对html进行渲染。

result.html：

?
1
2
3
4
5
<ul>
{% for choice in choices %}
    <li> {{ choice }} </li>
{% endfor %}
</ul>

　html可以直接使用mytags里面的结果，作为变量调用。

test.html：

?
1
2
3
4
5
6
7
8
9
10
11
{% load mytags %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
{% test %}
</body>
</html>

　　

视图函数：

?
1
2
def test(request):
    return render(request,'test.html')

　　

结果：

　

 

　

c、分配标签

类似于简单标签，但并不会输出结果，可以使用 as 关键字将结果赋给一个参数。

?
1
2
3
@register.assignment_tag
def get_current_time(format_string):
    return datetime.datetime.now().strftime(format_string)

　　

?
1
2
{% get_current_time "%Y-%m-%d %I:%M %p" as the_time %}
<p>The time is {{ the_time }}.</p>

　　

10、模板继承

a、include 模板标签

一般情况下，我们可以将header、footer做成统一风格的html模板，然后在网页中直接include即可。

但是实际情况下，我们一般使用base.html，然后通过extend base.html来操作，这样更加方便。

 

b、extend(继承)模板标签

base.html

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
    <title>{% block title %}{% endblock %}</title>
</head>
<body>
    <h1>My helpful timestamp site</h1>
 
    {% block body%}{% endblock %}
 
    {% block footer %}
    <hr>
    <p>Thanks for visiting my site.</p>
    {% endblock %}
  
    {% block js %}{% endblock %}
      
</body>
</html>

　　

继承模板：

?
1
2
3
4
5
6
7
{% extends "base.html" %}
 
{% block title %}The current time{% endblock %}
 
{% block body %}
    <p>It is now {{ current_date }}.</p>
{% endblock %}

　　

 

后记

一、变量

 1.变量的形式是：{{variable}}， 当模板引擎碰到变量的时候，引擎使用变量的值代替变量。
    2.使用dot(.)能够访问变量的属性
    3.当模板引擎碰到dot的时候，查找的顺序是什么样子呢？
        a.字典查找，例如：foo["var1"]
        b.属性查找，例如：foo.bar
        c.方法查找，例如：foo.bar()
        d.list-index查找，例如foo[bar]

注意：方法查找比一般的查找要复杂一些
(1)如果调用方法期间，方法抛出一个异常，那么异常将会产生，除非异常对象带有一个属性silent_variable_failure，
如果这个值是True，那么将会返回一个空字串。
(2)方法调用仅仅对那些没有参数的方法才会生效
(3)一些方法会产生副作用，所以系统允许方法设置一个属性alters_data，如果值为True，那么将不能够调用
其设置方法是：
def sensitive_function(self):
#函数内容
sensitive_function.alters_data = True

    4.如果模板中使用的某个变量不存在，那么模板系统将使用setting.py中 变量TEMPLATE_STRING_IF_INVALID的值进行替代，在默认情况下，该变量的值是''。


二、过滤器


    1.可以通过过滤器来修改变量的显示，过滤器的形式是：{{ variable | filter }}，管道符号'|'代表使用过滤器
    2.过滤器能够采用链式的方式使用，例如：{{ text | escape | linebreaks }}
    3.过滤器还可以带参数，例如： {{ bio|truncatewords:30 }}
    4.过滤器的参数中如果带有空格，那么需要用引号引起来，例如：{{ list | join : ", "}}
    5.django中30个内建的过滤器
(1)add  
使用形式为：{{ value | add: "2"}}
意义：将value的值增加2
(2)addslashes
使用形式为：{{ value | addslashes }}
意义：在value中的引号前增加反斜线
(3)capfirst
使用形式为：{{ value | capfirst }}
意义：value的第一个字符转化成大写形式
(4)cut
使用形式为：{{ value | cut:arg}}， 例如，如果value是“String with spaces” arg是" "那么输出是"Stringwithspaces"
意义：从给定value中删除所有arg的值
(5)date
使用形式为：：
(a) {{ value | date:"D d M Y" }}，例如，如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串"Wed 09 Jan 2008"
(b) {{ value | date }}，这种形式没有格式化字符串，这时候，格式化字符串会自动采用DATE_FORMAT所设置的形式。
意义：将日期格式数据按照给定的格式输出
(6)default
使用形式：{{ value | default: "nothing" }}，例如，如果value是“”，那么输出将是nothing
意义：如果value的意义是False，那么输出使用缺省值
(7)default_if_none
使用形式：{{ value | default_if_none:"nothing" }}，例如，如果value是None，那么输出将是nothing
意义：如果value是None，那么输出将使用缺省值
(8)dictsort
意义：如果value的值是一个字典，那么返回值是按照关键字排序的结果
使用形式：{{ value | dictsort:"name"}}，例如，
如果value是：

[
{'name': 'zed', 'age': 19},
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31},
]
那么，输出是：
[
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31},
{'name': 'zed', 'age': 19},
] 

 

(9)dictsortreversed
意义：如果value的值是一个字典，那么返回值是按照关键字排序的结果的反序
使用形式：与上述(8)完全相同。
(10)divisibleby
使用形式：{{ value | divisibleby:arg}}，如果value是21，arg是3，那么输出将是True
意义：如果value能够被arg整除，那么返回值将是True 

 

(11)escape
使用形式：{{ value | escape}}
意义：替换value中的某些字符，以适应HTML格式，包括：
< is converted to &lt;
> is converted to &gt;
' (single quote) is converted to &#39;
" (double quote) is converted to &quot;
& is converted to &amp;

escape仅仅在输出的时候才起作用，所以escape不能够用在链式过滤器的中间，
他应该总是最后一个过滤器，如果想在链式过滤器的中间使用，那么可以使用force_escape

 

 (12)escapejs
使用形式：{{ value | escapejs }}
意义：替换value中的某些字符，以适应JAVASCRIPT和JSON格式。
(13)filesizeformat
使用形式：{{ value | filesizeformat }}
意义：格式化value，使其成为易读的文件大小，例如：13KB，4.1MB等。 

 

(14)first
使用形式：{{ value | first }}
意义：返回列表中的第一个Item，例如，如果value是列表['a','b','c']，那么输出将是'a'。 

 

(15)floatformat
使用形式：{{ value | floatformat}}或者{{value|floatformat:arg}}，
arg可以是正数也可以是负数。没有参数的floatformat相当于floatformat:-1
(1)如果不带arg，那么引擎会四舍五入，同时最多只保留一位小数。

 

34.23234 {{ value|floatformat }} 34.2
34.00000 {{ value|floatformat }} 34
34.26000 {{ value|floatformat }} 34.3

 

(2)如果arg是正数，那么引擎会四舍五入，同时保留arg位的小数。

 

34.23234 {{ value|floatformat:3 }} 34.232
34.00000 {{ value|floatformat:3 }} 34.000
34.26000 {{ value|floatformat:3 }} 34.260

 

(3)如果arg是负数，那么引擎会四舍五入，如果有小数部分，那么保留arg位小数；否则，则没有任何小数部分。

 

34.23234 {{ value|floatformat:"-3" }} 34.232
34.00000 {{ value|floatformat:"-3" }} 34
34.26000 {{ value|floatformat:"-3" }} 34.26

 

(16)get_digit
使用形式：{{ value | get_digit:"arg"}}，例如，如果value是123456789，arg是2，那么输出是8
意义：给定一个数字，返回，请求的数字，记住：1代表最右边的数字，如果value不是合法输入，
那么会返回所有原有值。 

 

(17)iriencode
使用形式：{{value | iriencode}}
意义：如果value中有非ASCII字符，那么将其进行抓化成URL中适合的编码，如果value已经进行过URLENCODE，
改操作就不会再起作用。 

 

(18)join
使用形式：{{ value | join:"arg"}}，如果value是['a','b','c']，arg是'//'那么输出是a//b//c
意义：使用指定的字符串连接一个list，作用如同python的str.join(list) 

 

(19)last
使用形式：{{ value | last }}
意义：返回列表中的最后一个Item

 

(20)length
使用形式：{{ value | length }}
意义：返回value的长度。

 

(21)length_is
使用形式：{{ value | length_is:"arg"}}
意义：返回True，如果value的长度等于arg的时候，例如：如果value是['a','b','c']，arg是3，那么返回True 

 

(22)linebreaks
使用形式：{{value|linebreaks}}
意义：value中的"\n"将被<br/>替代，并且整个value使用</p>包围起来，从而适和HTML的格式 

 

(23)linebreaksbr
使用形式：{{value |linebreaksbr}}
意义：value中的"\n"将被<br/>替代 

 

(24)linenumbers
使用形式：{{value | linenumbers}}
意义：显示的文本，带有行数。

 

(25)ljust
使用形式：{{value | ljust}}
意义：在一个给定宽度的字段中，左对齐显示value 

 

(25)center
使用形式：{{value | center}}
意义：在一个给定宽度的字段中，中心对齐显示value 
(25)rjust
使用形式：{{value | rjust}}
意义：在一个给定宽度的字段中，右对齐显示value 

 

(26)lower
使用形式：{{value | lower}}
意义：将一个字符串转换成小写形式 

 

(27)make_list
使用形式：{{value | make_list}}
意义：将value转换成一个list，对于字符串，转换成字符list；对于整数，转换成整数list
例如value是Joel，那么输出将是[u'J',u'o',u'e',u'l']；value是123，那么输出将是[1,2,3] 

 

(28)pluralize
使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}，或者{{value | pluralize:"y,ies"}}
意义：如果value不是1，则返回一个复数后缀，缺省的后缀是's' 

 

(29)random
使用形式：{{value | random}}
意义：从给定的list中返回一个任意的Item 

 

(30)removetags
使用形式：{{value | removetags:"tag1 tag2 tag3..."}}
意义：删除value中tag1,tag2....的标签。例如，如果value是<b>Joel</b> <button>is</button> a<span>slug</span>
tags是"b span"，那么输出将是：Joel <button>is</button> a slug 

 

(31)safe
使用形式：{{value | safe}}
意义：当系统设置autoescaping打开的时候，该过滤器使得输出不进行escape转换 

 

(32)safeseq
与上述safe基本相同，但有一点不同的就是：safe是针对字符串，而safeseq是针对多个字符串组成的sequence 

 

(33)slice
使用形式：{{some_list | slice:":2"}}
意义：与python语法中的slice相同，:2表示第一的第二个元素 

 

(34)slugify
使用形式：{{value | slugify}}
意义：将value转换成小写形式，同事删除所有分单词字符，并将空格变成横线
例如：如果value是Joel is a slug，那么输出将是joel-is-a-slug 

 

(35)stringformat
这个不经常用，先不说 

 

(36)striptags
使用形式：{{value | striptags}}
意义：删除value中的所有HTML标签 

 

(37)time
使用形式：{{value | time:"H:i"}}或者{{value | time}}
意义：格式化时间输出，如果time后面没有格式化参数，那么输出按照TIME_FORMAT中设置的进行。 

 

(38)title
转换一个字符串成为title格式。 

 

(39)truncatewords
使用形式：{{value | truncatewords:2}}
意义：将value切成truncatewords指定的单词数目
例如，如果value是Joel is a slug 那么输出将是：Joel is ... 

 

(40)truncatewords_html
使用形式同(39)
意义：truncation点之前如果某个标签打开了，但是没有关闭，那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低，所有只有在value是html格式时，才考虑使用。 

 

(41)upper
转换一个字符串为大写形式

 

 (42)urlencode
将一个字符串进行URLEncode 

 

(43)urlize
意义：将一个字符串中的URL转化成可点击的形式。
使用形式：{{ value | urlize }}
例如，如果value是Check out www.djangoproject.com，那么输出将是：
Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a> 

 

(44)urlizetrunc
使用形式：{{ value | urlizetrunc:15}}
意义：与(43)相同，但是有一点不同就是现实的链接字符会被truncate成特定的长度，后面以...现实。 

 

(45)wordcount
返回字符串中单词的数目 

 

(46)wordwrap
使用形式：{{value | wordwrap:5}}
意义：按照指定的长度包装字符串
例如，如果value是Joel is a slug，那么输出将会是：
Joel
is a
slug 

 

(47)timesince
使用形式：{{value | timesince:arg}}
意义：返回参数arg到value的天数和小时数
例如，如果 blog_date 是一个日期实例表示 2006-06-01 午夜， 而 comment_date 是一个日期实例表示 2006-06-01 早上8点，
那么 {{ comment_date|timesince:blog_date }} 将返回 "8 hours". 

 

(48)timeuntil
使用形式：{{value | timeuntil}}
意义：与(47)基本相同，一个不同点就是，返回的是value距离当前日期的天数和小时数。 

 



 


三、标签 


 


1.标签的形式是：{% tag %}，标签要比变量复杂 


 


2.标签的作用
(1)在输出时创建一些文本
(2)通过执行循环和一些逻辑来实现控制流
(3)装载一些外部信息进入模板 


 


3.内建标签 


 


(1)autoescape
使用形式：
{% autoescape off %}
(内容)
{% endautoescape %}
意义：当某块内容不需要自动转义的时候，这样写就可以了。当然如果块内某些地方需要转义的话，调用filter也可以。


 


(2)block
使用形式：
{% block %}
(定义块内容)
{% endblock %}
意义：定义一个块，该块能够被继承他的子孙模板重写 


 


(3)comment
使用形式：
{% comment %}
(内容)
{% endcomment %}
意义：模板系统会忽略该标签内部的所有内容。


 


(4)cycle
使用形式：
例如:
<tr class="{% cycle list%}">
...
</tr>
意义：在循环时轮流使用给定的字符串列表中的值。 



 


(5)extends
使用形式：{% extends "base.html" %}或者{% extends variable %}变量可以是一个字符串，也可以是一个模板对象。
意义：表示本模板要对指定的父模板进行扩展。 


 


(6)filter
使用形式：
{%filter force_escape|lower%}
(内容)
{%endfilter%}
意义：将filter 标签圈定的内容执行过滤器操作。 


 


(7)firstof
使用形式：{%firstof var1 var2 var3%}
意义：输出第一个值不等于False的变量
等价于： 
{% if var1 %}
{{ var1 }}
{% else %}
{% if var2 %}
{{ var2 }}
{% else %}
{% if var3 %}
{{ var3 }}
{% endif %}
{% endif %}
{% endif %} 


 


(8)for
使用形式：
{% for variable in list/dict %}
(使用variable)
{% endfor%}
意义：循环list中的每个值，进行相应的输出
注意：(a)也可以反向遍历{% for variable in list/dict reversed %}
(b)也可以{% for x, y in points %} points中的每个元素为 (x,y)
(c)也可以{% for key,value in data.items %} data是一个dictionary 
for loop中定义的一些内建变量
forloop.counter 当前的迭代器数目(从1开始)
forloop.counter0 当前的迭代器数目(从0开始)
forloop.revcounter 当前的反向迭代器数目(从1开始)
forloop.revcounter0 当前的反向迭代器数目(从0开始)
forloop.first 值为True，如果是第一次通过迭代器
forloop.last 值为True，如果是最后一次通过迭代器
forloop.parentloop 对于嵌套循环，这是当前循环的上一层循环 


 


(9)for ... empty
使用形式如下：
{% for varibale in list %}
(内容1)
{% empty %}
(内容2)
{% endfor %}
意义：当list是空的时候，能够执行内容2，其形式等同于，先if判断list是否存在，然后在根据情况做什么操作。 


 


(10)if
使用形式如下 ：
{% if variable %}
(内容1)
{% else %}
(内容2)
{% endif %}
注意：variable中可以使用and or 或者not，但是有一条必须记住，就是不允许and 和 or一起使用 


 


(11)ifchanged
使用形式：
(a)如果直接检测循环变量是否变化，那么使用：
{% ifchanged %} 
(内容)
{% endifchanged %}
(b)如果检测循环变量的某个dot变量，例如循环变量是date，那么检测date.hour，那么使用：
{% ifchanged date.hour%} 
(内容)
{% endifchanged %} 
(c)ifchanged也可以加上一个{% else %}语句
意义：检测本次循环的值和上一次循环的值一样不一样，只能用在循环里面。  


 


(12)ifequal
使用形式：
{% ifequal variable1 variable2 %}
...
{% endifequal %}
意义：判断两个变量是否相等。 


 


(13)ifnotequal
使用与(12)相同 


 


(14)include
使用形式：{% include "foo/bar.html" %}或者{% include template_name %}
意义：将另外一个模板文件中的内容添加到该文件中。注意区别extend是继承。
(15)now
使用形式：{% now "jS F Y H:i "%}，注意存在需要转义的情况例如{% now "jS o\f F" %}，因为f是格式化字符串

具体的格式化字符串如下所示


 






a
'a.m.' or 'p.m.' (Note that this is slightly different than PHP's output, because this includes periods to match Associated Press style.)
'a.m.'




A
'AM' or 'PM'.
'AM'




b
Month, textual, 3 letters, lowercase.
'jan'




B
Not implemented.
 




d
Day of the month, 2 digits with leading zeros.
'01' to '31'




D
Day of the week, textual, 3 letters.
'Fri'




f
Time, in 12-hour hours and minutes, with minutes left off if they're zero. Proprietary extension.
'1', '1:30'




F
Month, textual, long.
'January'




g
Hour, 12-hour format without leading zeros.
'1' to '12'




G
Hour, 24-hour format without leading zeros.
'0' to '23'




h
Hour, 12-hour format.
'01' to '12'




H
Hour, 24-hour format.
'00' to '23'




i
Minutes.
'00' to '59'




I
Not implemented.
 




j
Day of the month without leading zeros.
'1' to '31'




l
Day of the week, textual, long.
'Friday'




L
Boolean for whether it's a leap year.
True or False




m
Month, 2 digits with leading zeros.
'01' to '12'




M
Month, textual, 3 letters.
'Jan'




n
Month without leading zeros.
'1' to '12'




N
Month abbreviation in Associated Press style. Proprietary extension.
'Jan.', 'Feb.', 'March','May'




O
Difference to Greenwich time in hours.
'+0200'




P
Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off if they're zero and the special-case strings 'midnight' and 'noon' if appropriate. Proprietary extension.
'1 a.m.', '1:30 p.m.','midnight', 'noon', '12:30p.m.'




r
RFC 2822 formatted date.
'Thu, 21 Dec 2000 16:01:07+0200'




s
Seconds, 2 digits with leading zeros.
'00' to '59'




S
English ordinal suffix for day of the month, 2 characters.
'st', 'nd', 'rd' or 'th'




t
Number of days in the given month.
28 to 31




T
Time zone of this machine.
'EST', 'MDT'




U
Not implemented.
 




w
Day of the week, digits without leading zeros.
'0' (Sunday) to '6'(Saturday)




W
ISO-8601 week number of year, with weeks starting on Monday.
1, 53




y
Year, 2 digits.
'99'




Y
Year, 4 digits.
'1999'




z
Day of the year.
0 to 365




Z
Time zone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive.






 


(16)spaceless
使用形式：{% spaceless %}
(内容)
{% endspaceless %}
意义：删除包围内容中的所有tab或者回车字符。
(17)template
使用形式：{% templatetag %}
意义：模板系统本身没有转义的概念，因此如果要输出一个像“{%”这样的东东，就需要采用这种方式，否则就会语法错误
其参数有：


 






openblock
{%




closeblock
%}




openvariable
{{




closevariable
}}




openbrace
{




closebrace
}




opencomment
{#




closecomment
#}






 


(18)with
使用形式：
{% with "expensive var1" as var2 %}
{% endwith %}
意义：当一个变量的访问消耗很大的模板解析时，可以用另外一个变量替换它，这种替换只有在with内部有效。 


 


(19)url
使用形式：{% url path.to.some_view arg1,arg2 %}
意义：给定某个module中函数的名字，给定参数，那么模板引擎给你一个URL，从而避免硬编码URL到代码中

注意：前提是URLconf中存在相应的映射,如果URLconf中没有该映射，那么会抛出异常，
这是可以选择使用
{% url path.to.view arg1 ,arg2 as the url %}
<a href="{{ the_url }}">Link to optional stuff</a>
其实这相当于
{% url path.to.view as the_url %}
{% if the_url %}
<a href="{{ the_url }}">Link to optional stuff</a>
{% endif %}


 






            

            
posted @ 
 
skyflask 
阅读(422) 
评论(0) 
编辑 
收藏 
举报


        

	    
	    
    









    
    

    
    



    

        
    

        

            
                
                
            
        

    

编辑推荐：



· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
    

· AI与.NET技术实操系列：向量存储与相似性搜索在 .NET 中的实现
    

· 基于Microsoft.Extensions.AI核心库实现RAG应用
    

· Linux系列：如何用heaptrack跟踪.NET程序的非托管内存泄露
    

· 开发者必知的日志记录最佳实践
    



    

    阅读排行：
    

 ·          winform 绘制太阳，地球，月球 运作规律
        

 ·          AI与.NET技术实操系列（五）：向量存储与相似性搜索在 .NET 中的实现
        

 ·          超详细：普通电脑也行Windows部署deepseek R1训练数据并当服务器共享给他人
        

 ·          上周热点回顾（3.3-3.9）
        

 ·          AI 智能体引爆开源社区「GitHub 热点速览」
        



    

    



	

	

	
	

	

	

	





    

        
    


    
    








  

  
点击右上角即可分享

  微信分享提示