Django之模版层
阅读原文时间:2023年07月10日阅读:1

一、模版简介

你可能已经注意到我们在例子视图中返回文本的方式有点特别,也就是说,HTML被直接硬编码在python代码之中。

def current_datetime(request):
now = datetime.datetime.now()
html = "It is now %s." % now
return HttpResponse(html)

尽管这种技术便于解释视图是如何工作的,但直接将HTML硬编码到你到视图里却并不是一个好主意。具体原因如下:

  • 对页面设计进行任何改变都必须对python代码进行相应对修改,站点设计对修改往往比底层python代码对修改要频繁得多,因此如果可以在不进行 Python 代码修改的情况下变更设计,那将会方便得多。
  • python代码编写和 HTML 设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
  • 程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。  

基于这些原因,将页面设计和python对代码分离开会更干净简洁更容易维护,我们可以使用Django对模版系统(Template System)来实现这种模式

python的模版:HTML代码+模版语法

def current_time(req):
# ================================原始的视图函数
# import datetime
# now=datetime.datetime.now()
# html="现在时刻:

%s.

" %now

# ================================django模板修改的视图函数  
# from django.template import Template,Context  
# now=datetime.datetime.now()  
# t=Template('<html><body>现在时刻是:<h1>{{current\_date}}</h1></body></html>')  
# #t=get\_template('current\_datetime.html')  
# c=Context({'current\_date':str(now)})  
# html=t.render(c)  
#  
# return HttpResponse(html)

#另一种写法(推荐)  
import datetime  
now=datetime.datetime.now()  
return render(req, 'current\_datetime.html', {'current\_date':str(now)\[:19\]})

模版语法重点:

  变量:{{ 变量名 }}

    1 深度查询 用句点符

    2 过滤器

  标签:{{%  % }}

二、模版语法之变量

在Django模版中遍历复杂数据结构的关键是句点字符串,语法:{ {变量名} }

views.py

def template_test(request):
name = 'lqz'
li = ['lqz', 1, '18']
dic = {'name': 'lqz', 'age': 18}
ll2 = [
{'name': 'lqz', 'age': 18},
{'name': 'lqz2', 'age': 19},
{'name': 'egon', 'age': 20},
{'name': 'kevin', 'age': 23}
]
ll3=[]
class Person:
def __init__(self, name):
self.name = name

    def test(self):  
        print('test函数')  
        return 11

    @classmethod  
    def test\_classmethod(cls):  
        print('类方法')  
        return '类方法'

    @staticmethod  
    def static\_method():  
        print('静态方法')  
        return '静态方法'

lqz = Person('lqz')  
egon = Person('egon')  
person\_list = \[lqz, egon\]  
bo = True  
te = test()  
import datetime  
now=datetime.datetime.now()  
link1='<a href="https://www.baidu.com">点我<a>'  
from django.utils import safestring  
link=safestring.mark\_safe(link1)  
# html特殊符号对照表(http://tool.chinaz.com/Tools/htmlchar.aspx)

# 这样传到前台不会变成特殊字符,因为django给处理了  
dot='&spades;'

# return render(request, 'template\_index.html', {'name':name,'person\_list':person\_list})  
return render(request, 'template\_index.html', locals())

html

{{ name }}


{{ li }}


{{ dic }}


{{ lqz }}


{{ person_list }}


{{ bo }}


{{ te }}

        <hr>  
        <h3>深度查询句点符</h3>  
        <p>{{ li.1 }}</p>  
        <p>{{ dic.name }}</p>  
        <p>{{ lqz.test }}</p>  
        <p>{{ lqz.name }}</p>  
        <p>{{ person\_list.0 }}</p>  
        <p>{{ person\_list.1.name }}</p>

        <hr>  
        <h3>过滤器</h3>  
        {#注意:冒号后面不能加空格#}  
        <p>{{ now | date:"Y-m-d H:i:s" }}</p>

        {#如果变量为空,设置默认值,空数据,None,变量不存在,都适用#}  
        <p>{{ name |default:'数据为空' }}</p>  
        {#计算长度,只有一个参数#}  
        <p>{{ person\_list |length }}</p>  
        {#计算文件大小#}  
        <p>{{ 1024 |filesizeformat }}</p>

        {#字符串切片,前闭后开,前面取到,后面取不到#}  
        <p>{{ 'hello world lqz' |slice:"2:-1" }}</p>  
        <p>{{ 'hello world lqz' |slice:"2:5" }}</p>

        {#截断字符,至少三个起步,因为会有三个省略号(传负数,1,2,3都是三个省略号)#}  
        <p>{{ '刘清政 world lqz' |truncatechars:"4" }}</p>  
        {#截断文字,以空格做区分,这个不算省略号#}  
        <p>{{ '刘清政   是      大帅比 谢谢' |truncatewords:"1" }}</p>

        <p>{{ link1 }}</p>  
        <p>{{ link1|safe }}</p>  
        <p>{{ link }}</p>

        <p>&spades;</p>  
        <p>{{ dot }}</p>

        {#add   可以加负数,传数字字符串都可以#}  
        <p>{{ "10"|add:"-2" }}</p>  
        <p>{{ li.1|add:"-2" }}</p>  
        <p>{{ li.1|add:2 }}</p>  
        <p>{{ li.1|add:"2" }}</p>  
        <p>{{ li.1|add:"-2e" }}</p>

        {#upper#}  
        <p>{{ name|upper }}</p>  
        <p>{{ 'LQZ'|lower }}</p>  
        <hr>  
        <h3>模版语法之标签</h3>  
        {#for 循环 循环列表,循环字典,循环列表对象#}  
        <ui>  
            {% for foo in dic %}  
                {{ foo }}  
            {% endfor %}  
            {#也可以混用html标签#}  
            {% for foo in li %}  
                <ul>foo</ul>

            {% endfor %}  
        </ui>  
        {#表格#}  
        <table border="1">

            {% for foo in ll2 %}  
                <tr>  
                    <td>{{ foo.name }}</td>  
                    <td>{{ foo.age }}</td>  
                </tr>  
            {% endfor %}  
        </table>  
        <table border="1">  
            {#'parentloop': {}, 'counter0': 0, 'counter': 1, 'revcounter': 4, 'revcounter0': 3, 'first': True, 'last': False}#}  
            {% for foo in ll2 %}  
                <tr>  
                    <td>{{ forloop.counter }}</td>  
                    <td>{{ foo.name }}</td>  
                    <td>{{ foo.age }}</td>  
                </tr>  
            {% endfor %}

        </table>

        {% for foo in ll5 %}  
            <p>foo.name</p>  
        {% empty %}  
            <p>空的</p>  
        {% endfor %}

        <hr>  
        <h3>if判断</h3>  
        {% if name %}  
            <a href="">hi {{ name }}</a>  
            <a href="">注销</a>  
        {% else %}  
            <a href="">请登录</a>  
            <a href="">注册</a>  
        {% endif %}  
        {#还有elif#}  
        <hr>  
        <h3>with</h3>  
        {% with ll2.0.name as n %}  
            {{ n }}  
        {% endwith %}  
        {{ n }}

        {% load my\_tag\_filter %}

        {{ 3|multi\_filter:3 }}

        {#传参必须用空格区分#}  
        {% multi\_tag 3 9 10 %}

        {#可以跟if连用#}  
        {% if 3|multi\_filter:3 > 9 %}  
            <p>大于</p>  
        {% else %}  
            <p>小于</p>  
        {% endif %}

主意:句点符也可以用来引用对象的方法(无参数方法):

<h4>字典:{{ dic.name.upper }}<``/``h4>

三、模版之过滤器

语法:

{{obj|filter__name:param}} 变量名字|过滤器名称:变量

如果一个变量是false或者为空,使用给定的默认值。否则,使用变量的值。例如:

{ { value|default:'nothing' } }

返回值的长度。它对字符串和列表都起作用。例如:

{{ value|length }}

如果value是[‘a’,'b','c','d'],那么输出是4.

将值格式化为一个 “人类可读的” 文件尺寸 (例如 '13 KB''4.1 MB''102 bytes', 等等)。例如:

{{ value|filesizeformat }}

如果 value 是 123456789,输出将会是 117.7 MB

如果 value=datetime.datetime.now()

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

如果 value=‘hello world’

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

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

参数:要截断的字符数

例如:

{{ value|truncatechars:9 }}

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

value="点击"

{{ value|safe}}

过滤器

描述

示例

upper

以大写方式输出

{{ uaer.name | upper}}

add

给value加上一个数值

{{ uaer.age | add:'5'}}

addslashes

单引号加上转义号

 

capfirst

第一个字母大写

{{ ‘good’ | capfirst}} 返回'Good'

center

输出指定长度的字符串,把变量剧中

{{ ‘abcd’ | center:'50'}}

cut    

删除指定字符串

{{ 'you are not a Englishman' | cut:'not'}}

date

格式化日期

 

default

如果值不存在,则使用默认值代替

{{ value | default:'(N/A)'}}

default_if_none

如果值为None,则使用默认值代替

 

dictsort

按某字段排序,变量必须是dictionary

{% for moment in moments | dictsort:'id'%}

dictsortreversed

按某字段倒序排序,变量必须是dictionary

 

divisibleby

判断是否可以被数字整除

{{ 224 | divisibleby:2}} 返回 Ture

escape

按HTML转义,比如将‘<’转换为‘&lt’

 

filesizeformat

增加数字的可读性,转换结果为13k,89M,3Bytes等

{{ 1024 | filesizefoemat}} 返回1.0kb 

first

返回列表的第一个元素,变量必须是一个列表

 

floatformat

转换为指定精度的小数,默认保留1位小数

{{ 3.1415926 | floatformat:3}} 返回3.142四舍五入

get_digit

从个位数开始截取指定位置的数字

{{ 123456 | get_digit:'1'}}

join 

用指定分隔符连接列表

{{['abc','45'] | join:"*"}} 返回abc*45

length_is

检查列表,字符串长度是否符合指定的值

{{'hello'|length_is:'3'}}

linebreaks


标签包裹变量

{{"Hi\n\nDavid" | linebreaks}} 返回

Hi

David

linebreaksbr


标签代替换行符

 

linenumbers

为变量中的每一行加上行号

 

ljust

输出指定长度的字符串

 

lower

字符串变小写

 

make_list

将字符串转换为列表

 

pluralize

根据数字确定是否输出英文复数符号

 

random

返回列表的随机一项

 

removetags

删除字符串中指定的HTML标记

{{ value | removetags:'h1 h2'}}

rjust

输出指定长度的字符串,变量右对齐

 

slice

切片操作,返回列表

{{[3,9,1] | slice:':2'}} 返回[3,9]

{{'asdfghklljjh' | ':5'}} 返回‘’asdfg‘

 slugify

在字符串中留下减号和下划线,其它符号删除,空格用减号替换

{{ '5-2==3and5 2=3' | slugify}} 返回5-23and5-23

stringformat

字符串格式化,语法同python

 

time

返回日期的时间部分

 

timesince

以“到现在为止过了多长时间”显示时间变量

结果可能为45days,3hours

timeuntil

以“从现在开始到时间变量”还有多长时间显示时间变量

 

title

每个单词首字母大写

 

truncatewords_html

同下,但保留其中但HTML标签

{{'

This is a pen

' | truncatewords:2}}返回

This is ...

truncatewords

将字符串转换为省略表达方式

{{'This is a pen' | truncatewords:2}}返回

This is …

urlencode

将字符串中但特殊字符转换为url兼容表达式方式

{{'http://www.aaa.com/foo?a=b&b=c' | urlencode}}

urlsize

将变量字符串中的url由纯文本变为链接

 

wordcount

返回变量字符串中的单词数

 

yesno

将布尔变量转换为字符串yes,no或maybe

{{Ture | yesno}}

{{False | yesno}}

{{None | yesno}}

返回

yes

no

maybe

四、模版之标签

标签看起来像是这样的: {% tag %}。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模版中。一些标签需要开始和结束标签 (例如{% tag %} ...标签 内容 … {% endtag %})。

遍历每一个元素

{% for person in person_list %}

{{ person.name }}


{% endfor %}

可以利用{% for obj in list reversed %}反向完成循环。

遍历一个字典:

{% for key,val in dic.items %}

{{ key }}:{{ val }}


{% endfor %}

注:循环序号可以通过{{ forloop}} 显示

forloop.counter The current iteration of the loop (1-indexed) 当前循环的索引值(从1开始)
forloop.counter0 The current iteration of the loop (0-indexed) 当前循环的索引值(从0开始)
forloop.revcounter The number of iterations from the end of the loop (1-indexed) 当前循环的倒序索引值(从1开始)
forloop.revcounter0 The number of iterations from the end of the loop (0-indexed) 当前循环的倒序索引值(从0开始)
forloop.first True if this is the first time through the loop 当前循环是不是第一次循环(布尔值)
forloop.last True if this is the last time through the loop 当前循环是不是最后一次循环(布尔值)
forloop.parentloop 本层循环的外层循环

for 标签带有一个可选的{% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。

{% for person in person_list %}

{{ person.name }}

{% empty %}

sorry,no person here


{% endfor %}

{% if %}会对一个变量求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),对应的内容块会输出。

{% if num > 100 or num < 0 %}

无效

{% elif num > 80 and num < 100 %}

优秀


{% else %}

凑活吧


{% endif %}

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

使用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的

例如

{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
不要写成as

{% csrf_token%}

这个标签用于跨站请求伪造保护

五、自定义标签和过滤器

1、在settings中的INSTALLED_APPS配置当前app,不然django无法找到自定义的simple_tag.

2、在app中创建templatetags模块(模块名只能是templatetags)

3、创建任意 .py 文件,如:my_tags.py****

from django import template
from django.utils.safestring import mark_safe

register = template.Library() #register的名字是固定的,不可改变

@register.filter
def filter_multi(v1,v2):
return v1 * v2


@register.simple_tag
def simple_tag_multi(v1,v2):
return v1 * v2


@register.simple_tag
def my_input(id,arg):
result = "" %(id,arg,)
return mark_safe(result)

4、在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py

{% load my_tags %} 

5、使用simple_tag和filter(如何调用)

-------------------------------.html
{% load xxx %}

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 %}

注意:filter可以用在if等语句后,simple_tag不可以

{% if num|filter_multi:30 > 100 %}
{{ num|filter_multi:30 }}
{% endif %}

六、模版导入和继承

  语法:{% include '模版名称' %}

  如:{% include 'adv.html' %}

Panel title

Panel content

Panel title

Panel content

Panel title

Panel content

adv.html





Title

{# #}