Django框架04 /模板相关、别名/反向解析/路由分发

Django框架04 /模板相关、别名/反向解析/路由分发

1. 语法

关于模板渲染需要记两种特殊符号（语法）：

{{  }}

# 变量相关的用{{}}

{% %}

# 逻辑相关的用{ %  % }。

2. 变量/万能的点

代码示例

视图：test.py

def index(request):

    import datetime

    s = "hello"

    l = [111, 222, 333]   # 列表

    dic = {"name": "张三", "age": 18}   # 字典

    date = datetime.date(1993, 5, 2)   # 日期对象

    class Person(object):

        def __init__(self, name):

            self.name = name

        def dream(self):

            return 'dreamer'

    person_san = Person("张三")   # 自定义类对象

    person_si = Person("李四")

    person_wu = Person("王五")

    person_list = [person_san, person_si, person_wu]

    # 方式1：

    return render(request, "index.html", {"l": l, "dic": dic, "date": date, "person_list": person_list})

	# 方式2：

    return render(request,'index.html',locals())

    # locals()获取函数内容所有的变量，然后通过render方法给了index.html文件进行模板渲染

    # 如果图省事，可以用它，但是很多多余的变量也被传进去了，效率低

模板：test.html

<h4>{{s}}</h4>

<h4>列表:{{ l.0 }}</h4>

<h4>列表:{{ l.2 }}</h4>

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

<h4>字典:{{ dic.keys }}</h4>

<h4>字典:{{ dic.values }}</h4>

<h4>字典:{{ dic.items }}</h4>

<h4>日期:{{ date.year }}</h4>

<!--取列表的第1个对象的name属性的值-->

<h4>类对象列表:{{ person_list.0.name }}</h4>

<!--取列表的第1个对象的dream方法的返回值，如果没有返回值，拿到的是none-->

<h4>类对象列表:{{ person_list.0.dream }}</h4>

注意：

调用对象里面的方法的时候，不需要写括号来执行，并且只能执行不需要传参数的方法，如果你的这个方法需要传参数，那么模板语言不支持，不能帮你渲染

总结：
1. 在Django的模板语言中按此语法使用：{{ 变量名 }}
2. 当模版引擎遇到一个变量，它将计算这个变量，然后用结果替换掉它本身。
  
  变量的命名包括任何字母数字以及下划线 ("_")的组合。
  
  变量名称中不能有空格或标点符号。
3. 深度查询据点符（.）在模板语言中有特殊的含义。当模版系统遇到点(".")，它将以这样的顺序查询：
  - 字典查询（Dictionary lookup）
  - 属性或方法查询（Attribute or method lookup）
  - 数字索引查询（Numeric index lookup）
4. 如果计算结果的值是可调用的，它将被无参数的调用。调用的结果返回值将成为模版的值。
5. 如果使用的变量不存在，模版系统将插入 string_if_invalid 选项的值，它被默认设置为'' (空字符串)

3 . 过滤器

在Django的模板语言中，通过使用过滤器来改变变量的显示
1. 过滤器的语法：
```
{{ value|filter_name:参数 }}
```
2. 使用管道符"|"来应用过滤器
```
{{ name|lower }}

# 会将name变量应用lower过滤器之后再显示它的值,lower在这里的作用是将文本全都变成小写。
```
3. 注意：
  1. 过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
  2. 过滤器可以接受参数，例如：{{ text|truncatewords:30 }}，这将显示text的前30个词。
  3. 过滤器参数包含空格的话，必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素，
    
    如：{{ list|join:', ' }}
  4. '|'左右没有空格没有空格没有空格

常用过滤器 /Django的模板语言中提供了大约六十个内置过滤器

default

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

# 如果value没有传值或者值为空的话就显示nothing
```

length

返回值的长度，作用于字符串和列表。

{{ value|length }}

# 返回value的长度，如 value=['a', 'b', 'c', 'd']的话，就显示4.

filesizeformat

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

# 如果 value 是 123456789，输出将会是 117.7 MB。
```

slice 切片

value="hello world",

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

# 还有其他可切片的数据类型

date 格式化

value=datetime.datetime.now()

{{ value|date:"Y-m-d H:i:s"}}

# 关于时间日期的可用的参数(除了Y,m,d等等)还有很多

safe 不进行转义

为了安全，Django的模板中在进行模板渲染的时候会对HTML标签和JS等语法标签进行自动转义

通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义
```
value = "<a href='#'>点我</a>"和value="<script>alert('123')</script>"

{{ value|safe}}

# 这样a标签不会被转义，正常显示a标签
```

truncatechars

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

# 参数：截断的字符数

{{ value|truncatechars:9}} 

# 注意：最后那三个省略号也是9个字符里面的，也就是这个9截断出来的是6个字符+3个省略号，

# 如果想要展开，配合前端的点击事件就可以

truncatewords

在一定数量的字后截断字符串，是截多少个单词。(是通过空格区分不同的字符串)

value = ‘hello girl hi baby yue ma’,

{{ value|truncatewords:3}}

# 上面例子得到的结果是 'hello girl h1...'

cut

移除value中所有的与给出的变量相同的字符串

{{ value|cut:' ' }}

# 切掉空格，如果value为'i love you'，那么将输出'iloveyou'.

join

使用字符串连接列表，就像Python的str.join(list)（有空格的话，也要将空格包含在引号的里边）
```
{{ list|join:', ' }}

# 列表拼接成字符串
```

4. 标签Tags

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

for标签

遍历每一个元素：

写个for，然后 tab键自动生成for循环的结构，循环很基础，就这么简单的用，没有什么break之类的，复杂一些的功能，要通过js

{% for person in person_list %}

	<p>{{ person.name }}</p>  <!--凡是变量都要用两个大括号括起来-->

{% endfor %}

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

遍历一个字典:

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

    <p>{{ key }}:{{ val }}</p>

{% endfor %}

for ... empty

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

    <p>{{ person.name }}</p>

{% empty %}

    <p>sorry,no person here</p>

{% endfor %}
```

forloop

{% for i in data %}

	xx

	{{ forloop.counter }}

{% empty %}

	xx

{% endfor %}

forloop.counter        <!--当前循环的索引值(从1开始)，forloop是循环器，通过点来使用功能-->

forloop.counter0       <!--当前循环的索引值（从0开始）-->

forloop.revcounter     <!--当前循环的倒序索引值（最后一个位置是1）-->

forloop.revcounter0    <!--当前循环的倒序索引值（最后一个位置是0）-->

forloop.first          <!--当前循环是不是第一次循环（布尔值）-->

forloop.last           <!--当前循环是不是最后一次循环（布尔值）-->

forloop.parentloop  <!--本层循环的外层循环的对象，再通过上面的几个属性来显示外层循环的计数等-->

if标签

{% if %}

<!--会对一个变量求值，如果它的值是“True”（存在、不为空、且不是boolean类型的false值），对应的内容块会输出。-->

<!--if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断，注意条件两边都有空格。-->

if else

{% if user_list|length > 5 %}  <!--结合过滤器来使用-->

  七座豪华SUV

{% else %}

    黄包车

{% endif %}

if elif else

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

    <p>无效</p>  <!--不满足条件，不会生成这个标签-->

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

    <p>优秀</p>

{% else %}  <!--也是在if标签结构里面的-->

    <p>凑活吧</p>

{% endif %}

with
- 相当于起别名，使用一个简单地名字缓存一个复杂的变量，多用于给一个复杂的变量起别名，当你需要使用一个“昂贵的”方法（比如访问数据库）很多次的时候是非常有用的
```
{% with total=business.employees.count %}

{{ total }} 

{% endwith %}

或

{% with business.employees.count as total %}

{{ total }}

{% endwith %}


```

5. 模板继承/母版继承

模板继承流程
1. 创建一个xx.html页面(作为母版,其他页面来继承它使用)
2. 在母版中定义block块(可以定义多个,整个页面任意位置)
```


{% block content %}

{% endblock %}
```
3. 其他页面继承写法
```


{% extends 'base.html' %}  必须放在页面开头
```
4. 页面中写和母版中名字相同的block块,从而来显示自定义的内容
```
{% block content %}  

{{ block.super }}  

这是子板

{% endblock %}
```
5. 注意：
  - 三个钩子/css钩子/body钩子/js钩子
  - extends 标签是这里的关键。它告诉模版引擎，这个模版“继承”了另一个模版
  - 如果使用 {% extends %} 标签，它必须是模版中的第一个标签。否则模版继承都将无法工作，模板渲染的时候django都不知道你在干啥
  - 为了更好的可读性，你也可以给你的 {% endblock %} 标签一个名字。例如：
    
    {% block content %}
    
    ...
    
    {% endblock content %}　　
    
    　　在大型模版中，这个方法帮你清楚的看到哪一个{% block %} 标签被关闭了。
  - 不能在一个模版中定义多个相同名字的 block 标签

代码示例：

base.html --- 模板/母板

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>base</title>

    <style>

        body{

            margin:0;

        }

        h1{

            margin:0;

            background-color:tomato;

            height: 50px;

            text-align:center;

        }

        .d1{

            margin-top:0;

            background-color:darkcyan;

            height:120px;

            width:20%;

            float:left;

        }

        .d2{

            margin-top:0;

            background-color:yellow;

            height:120px;

            width:80%;

            float:right;

            text-align:center;

            line-height:120px;

        }

    </style>

</head>

<body>

<div>

<h1>头条</h1>

</div>

<div class="d">

<div class="d1">

<ul>

    <a href="/menu1/"><li>菜单1</li></a>

    <a href="/menu2/"><li>菜单2</li></a>

    <a href="/menu3/"><li>菜单3</li></a>

</ul>

</div>

<div class="d2">

    {% block content %}

        模板

    {% endblock %}

</div>

</div>

</body>

</html>

home.html --- 主页

<!-- 继承 -->

{% extends 'base.html'%}

{% block content %}#}

主页

{% endblock %}

menu.html --- 菜单页

{% extends 'base.html'%}

{% block content %}

菜单一

{% endblock %}

既用到母板内容，又要新增内容

{% extends 'base.html'%}

{% block content %}

{{ block.super }}

菜单二

{% endblock %}

6. 组件

组件用法
1. 创建html页面,里面写上自己封装的组件内容,xx.html
2. 新的html页面使用这个组件
```
{% include 'xx.html' %}
```
组件与插件的区别
1. 组件是提供某一完整功能的模块，如：编辑器组件，QQ空间提供的关注组件等。
2. 而插件更倾向封闭某一功能方法的函数。
3. 这两者的区别在 Javascript 里区别很小，组件这个名词用得不多，一般统称插件。

代码示例：

template.html

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>template</title>

    <style>

        div{

            background-color:tomato;

            height:40px;

        }

    </style>

</head>

<body>

<div>

    <span>首页</span>

    <span>手机</span>

    <span>家居生活</span>

    <span>户外</span>

    <span>户内</span>

</div>

</body>

</html>

home.html
```
{% include 'template.html' %}
```

7. 自定义标签和过滤器

自定义标签和过滤器用法

在应用下创建一个叫做templatetags的文件夹(名称不能改),在里面创建一个py文件,例如myfilter.py

在xx.py文件中引用django提供的template类,写法

from django import template

register = template.Library() #register变量名称不能改

# 定义过滤器 参数至多两个

@register.filter

def xx(v1,v2):

    return xxx

# 使用:

{% load xx %}

{{ name|xx:'oo' }}

# 自定义标签 没有参数个数限制

@register.simple_tag

def huxtag(n1,n2):

    '''

    :param n1:  变量的值 管道前面的

    :param n2:  传的参数 管道后面的,如果不需要传参,就不要添加这个参数

    :return:

    '''

    return n1+n2

# inclusion_tag 返回html片段的标签

@register.inclusion_tag('result.html')

def res(n1):

    return {'li':n1 }

# 使用:

{% res a %}

代码示例

filters.py

from django import template

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

# 自定义过滤器

@register.filter

def filt(n1):

    return n1+'heihei'

# 自定义标签

@register.simple_tag

def tags(n1,n2):

    return n1+n2

test.html

<!-- 自定义过滤器 -->

{% load filters %}

{{ name|filt }}

<!-- 自定义标签 -->

{% load filters %}

{% tags name '888' %}

inclusion_tag应用示例

view.py

def home(request):

    return render(request,'home.html',{'name':['aa','bb','cc','dd']})

filters.py

from django import template

register = template.Library()

@register.inclusion_tag('result.html')

def res(n1):

    return {'l1':n1}

# 将result.html里面的内容用函数的返回值渲染，然后作为组件一样，加载到使用这个函数的html文件里面

home.html

<!-- 自定义经过加工的标签 -->

{% load filters %}

{% res name %}

result.html

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>result</title>

</head>

<body>

<ul>

    {% for i in l1 %}

    <li>{{ i }}+{{ i }}</li>

    {% endfor %}

</ul>

</body>

</html>

8. 静态文件配置

静态文件配置方法

‘项目目录下’创建一个文件夹,例如名为statics,将所有静态文件放到这个文件夹中

settings配置文件中进行下面的配置

# 静态文件相关配置

STATIC_URL = '/static/'  # 静态文件路径别名

STATICFILES_DIRS = [

    os.path.join(BASE_DIR, 'statics'),

]

应用静态文件的两种方式

方式一：

<link rel="stylesheet" href="/static/css/index.css">

方式二： -- {% static %}

{% load static %}

<script src="{% static "mytest.js" %}"></script>

代码示例

home.html

<!DOCTYPE html>

<html lang="zh-cn">

<head>

    <meta charset="UTF-8">

    <meta name="viewport"

          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">

    <meta http-equiv="X-UA-Compatible" content="ie=edge">

    <title>static_files</title>

    <link rel="stylesheet" href="/static/css/one.css">

</head>

<body>

<div>

    <span>头条</span>

</div>

</body>

</html>

static_files > css > one.css

div{

    background-color:tomato;

    height:50px;

    text-align:center;

    line-height:50px;

    font-weight:bold;

}

settings.py

STATIC_URL = '/static/'

STATICFILES_DIRS =[

    os.path.join(BASE_DIR,'static_files')

]

9. url别名和反向解析

别名写法

url(r'^index2/', views.index,name='index'),

反向解析

# 后端

from django.urls import reverse

reverse('别名')   # 例如:reverse('index') -- /index/

# 带参数的：

reverse('别名',args=(1,2)) --/index/1/2

reverse('别名',kwargs={'name':'xx'})

# 前端html

{% url '别名' %}   # 例如:{% url 'index' %} -- /index/

# 带参数的：

{% url 'index' xxx %} -- /index/xxx/

10. url命名空间

路由分发 include

1 在每个app下创建urls.py文件,写上自己app的路径

2 在项目目录下的urls.py文件中做一下路径分发,看下面内容

    from django.conf.urls import url,include

    from django.contrib import admin

    urlpatterns = [

        # url(r'^admin/', admin.site.urls),

        url(r'^app01/', include('app01.urls')),  # app01/home/

        url(r'^app02/', include('app02.urls')),

    ]

命名空间namespace

from django.conf.urls import url,include

from django.contrib import admin

urlpatterns = [

    # url(r'^admin/', admin.site.urls),

    url(r'^app01/',include('app01.urls',namespace='app01')),  # app01/home/

    url(r'^app02/', include('app02.urls',namespace='app02')),

]

# 反向解析使用:

# 后端:

	reverse('命名空间名称:别名') -- reverse('app01:home')

# hmtl:

	{% url '命名空间名称:别名' %}  -- {% url 'app01:home' %}

代码示例：

item > urls

from django.conf.urls import url,include

from django.contrib import admin

urlpatterns = [

    # url(r'^admin/', admin.site.urls),

    url(r'^app01/', include('app01.urls',namespace='app01')),

    url(r'^app02/', include('app02.urls',namespace='app02')),

]

app01 > urls

from django.conf.urls import url

from app01 import views

urlpatterns = [

    url(r'^home/', views.home,name='home'),

]

app02 > urls

from django.conf.urls import url

from app02 import views

urlpatterns = [

    url(r'^home/', views.home,name='home'),

]

app01 > views

from django.shortcuts import render,HttpResponse,redirect

from django.urls import reverse

def home(request):

    print('app01>>>',reverse('app01:home'))

    return HttpResponse('app01的home页面')

app02 > views

from django.shortcuts import render,HttpResponse,redirect

from django.urls import reverse

def home(request):

    print('app02>>>',reverse('app02:home'))

    return HttpResponse('app02的home页面')

补充：

多对多查询，前端显示

{% for server in projectenv.servers.all %}

	{{ server }}

{% endfor %}

choices选项前端显示
```
{{ projectenv.get_env_display }}
```

秒客网

Django框架04 /模板相关、别名/反向解析/路由分发