Django模板系统：Template

程序员文章站 2022-07-09 21:18:55

一、模板常用语法 1.1 变量 1. 符号：{{ }} 表示变量，在模板渲染的时候替换成值使用方式：{{ 变量名 }}：变量名由字母数字和下划线组成点（.）在模板语言中有特殊的含义，用来获取对象的相应属性值注意：当模板系统遇到一个（.）时，会按照如下的顺序去查询：在字典中查询属性或者方法 ......

一、模板常用语法

1.1 变量

符号：{{ }}
- 表示变量，在模板渲染的时候替换成值
- 使用方式：{{ 变量名 }}：变量名由字母数字和下划线组成
- 点（.）在模板语言中有特殊的含义，用来获取对象的相应属性值
- 注意：当模板系统遇到一个（.）时，会按照如下的顺序去查询：
  - 在字典中查询
  - 属性或者方法
  - 数字索引

1.2 内置filter

filter：过滤器，用来修改变量的显示结果
- 语法： {{ value|filter_name:参数 }}
- ':'左右没有空格没有空格没有空格
内置过滤器
- default：默认值
  - 语法：{{ value|default:"nothing"}}
  - 如果value值没传的话就显示nothing
  - 补充：templates的options可以增加一个选项：string_if_invalid：'找不到'，可以替代default的的作用
- filesizeformat：文件大小，将值格式化为可读的文件尺寸
  - 语法：{{ value|filesizeformat }}
  - 如，value=123456789，输出将会是 117.7 mb
- add：给变量加参数
  - 语法：{{ first|add:second }}
  - 优先看是否能转化为数字相加，其次是字符串拼接
  - 如果都是列表，相当于extend，循环加入
- length：返回长度
  - 语法：{{ value|length }}
  - 返回value的长度，如，value=['a', 'b', 'c', 'd']的话，就显示4
- slice：切片
  - 语法：{{value|slice:"2:-1"}}
- first / last：取第一个/最后一个元素
  - 语法：
    - 取第一个元素：{{ value|first }}
    - 取最后一个元素：{{ value|last }}
- join：使用字符串拼接列表
  - 语法：{{ value|join:" // " }}
- truncatechars：截断，按照字符计数
  - truncatewords：按照字母计数，不能识别中文
  - 如果字符串字符多于指定的字符数量，那么会被截断
  - 截断的字符串将以可翻译的省略号序列（...）结尾
  - 参数：截断的字符
  - 语法：{{ value|truncatechars:9}}
- date：日期格式化
  - 语法：{{ value|date:"y-m-d h:i:s"}}
  - 在settings.py中配置：
```
use_l10n = false

datetime_format = 'y-m-d h:i:s'    # datetime类型
date_format = 'y-m-d'            # date类型
time_format = 'h:i:s'            # time类型
```
  - 配置后，使用{{now}}可以实现日期格式化
    - 其中，'now':datetime.datetime.now()
- safe：告诉django这段代码是安全的，不需要转义
  - 语法：{{ value|safe}}
  - 如，value = "<a href='#'>点我</a>"

1.3 自定义filter

在app下创建一个名为templatetags的python包
在templatetags中创建py文件,文件名自定义（my_tags.py）;

在py文件中写：

from django import template
register = template.library()        # register也不能变

写函数+装饰器

@register.filter
def add_xx(value, arg):          # 最多有两个
    return '{}-{}'.format(value, arg)

@register.filter(name='adds')    # 相当于更改了函数名，使用时，使用新的函数名

在模板文件中使用，html文件

{% load my_tags %}
{{ 'alex'|add_xx:'dsb' }}

注意：
- 为避免出错，templatetags最好是一个python包，并且名称不能更改
- register名称也不能更改，必要时需要重启项目
- python包下的init中可能有其他内容django不能识别，导致出错，可以直接删除内容

1.4 标签tag

符号：{% %}

for循环

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

forloop：字典形式

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

for ... empty

{% for book in all_books %}
    <tr>
     .....
    </tr>
{% empty %}
    <td>没有相关的数据</td>
{% endfor %}

if判断
- if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断
```
{% if 条件1  %}
 xxx
{% elif 条件2  %}
    xxx
{% else  %}
 xxxxx
{% endif %}
```
- 连续判断
  - python中，10>5>1 --> 10>5 and 5>1 --> true
  - js中，10>5>1 --> true>1 --> 1>1 --> false
  - 模板中，不支持连续连续判断也不支持算数运算（可使用过滤器）

with：给变量重命名，但只在with区域内生效

{% with hobby.2 as talk %}
{# 相当于 {% with talk=hobby.2 %}，其中=两边不能有空格 #}
 {{ talk }}
{% endwith %}

csrf_token
- 该标签用于跨站请求伪造保护
  - csrf：跨站请求伪造
- 使用方式：在form表单中写上{% csrf_token %}
- 这样就不用在settings中注释含csrf的中间件了

1.5 注释

符号：{# 要注释的内容 #}
快捷键：ctrl + ?
```
{# 要注释的内容 #}
```

二、母板和继承

2.1 母板

母板就是一个普通的html，提取多个页面的公共部分，通过定义block块来实现

<!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>

block块：
```
{% block 块名 %}

{% endblock %}
```
注意：我们通常会在母板中定义页面专用的css块和js块，方便子页面替换

2.2 继承

子页面继承母板：{% extends '母板html' %}
```
{% extends 'layouts.html' %}
```

子页面通过重写block块，来替换母板中相应的内容

{% block page-main %}
    <p>世情薄</p>
    <p>人情恶</p>
    <p>雨送黄昏花易落</p>
{% endblock %}

2.3 注意

{% extends 'base.html' %}要写在第一行，前面不要有内容，否则内容会显示出来
{% extends 'base.html' %}中的'base.html' 必须加上引号，不然会被当做变量去查找
子页面把要显示的内容写在block块中，否则不会显示出来
多个位置有独特内容，可以定义多个block块，特殊：定义css、js块等

三、组件

组件：一小段html代码段
可以将常用的页面内容如导航条，页尾信息等组件保存在单独的文件中，然后在需要使用的地方导入
```
{% include 'navbar.html' %}
```

四、静态文件相关

目的：更改setting中静态文件的别名时，不影响在更改之前的静态文件的引用，即引用会跟随别名的更改而自动更改，这样就不会报错了

方法一：使用static，原本路径：/static/images/hi.jpg

{% load static %}
<img src="{% static "images/hi.jpg" %}" alt="hi">

文件多处被用到可以存为一个变量

{% load static %}
{% static "images/hi.jpg" as myphoto %}
<img src="{{ myphoto }}">

方法二：使用get_static_prefix，原本路径：/static/images/hi.jpg

{% load static %}
<img src="{% get_static_prefix %}images/hi.jpg" alt="hi">

{# 补充：获取别名 #}
{% get_static_prefix %}

文件多处被用到可以存为一个变量

{% load static %}
{% get_static_prefix as static_prefix %}
<img src="{{ static_prefix }}images/hi.jpg" alt="hi">

五、自定义simple_tag

和自定义filter类似，区别：接收的参数更灵活，能接收万能参数

定义注册simple_tag

@register.simple_tag
def join_str(*args, **kwargs):
    return '{} - {} '.format('*'.join(args), '$'.join(kwargs.values()))

@register.simple_tag(name='join')    # 相当于更改了函数名，使用时，使用新的函数名

使用自定义simple_tag

{% load my_tags %}
{% join_str '1' '2' k1='3' k2='4' %}

六、inclusion_tag

在app下的templatetags（python包）中创建py文件,文件名自定义（my_inclusion.py）;

在py文件中写：

from django import template
register = template.library()        # register也不能变

写函数+装饰器

@register.inclusion_tag('result.html')
# result.html 是内容的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}

在result.html中写：

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

在模板文件中使用

{% load my_inclusion %}
{% show_results 10 %}

上一篇：学习13.内容# 1.内置函数二 # 2.闭包

下一篇： JAVA基础之网络通信协议--TCP与UDP

Django模板系统：Template

一、模板常用语法

1.1 变量

1.2 内置filter

1.3 自定义filter

1.4 标签tag

1.5 注释

二、母板和继承

2.1 母板

2.2 继承

2.3 注意

三、组件

四、静态文件相关

五、自定义simple_tag

六、inclusion_tag

详解Django项目中模板标签及模板的继承与引用(网站中快速布置广告)

交给子类: Template Method（模板方法模式）【PHP】

江湖家居系统至尊版新鲜模板又出炉

建站资源：企业建站系统免费下载（内含响应式模板1套）

Go html/template 模板的使用实例详解

Django 笔记（四）模板标签 ~ 自定义过滤器

Django框架模板介绍

php Http_Template_IT类库进行模板替换

Django框架模板注入操作示例【变量传递到模板】

Django用户认证系统(三)组与权限