Python全栈：Django模板

最新推荐文章于 2024-05-02 11:22:28 发布

原创最新推荐文章于 2024-05-02 11:22:28 发布 · 387 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#python #Django #模板

计算机科学专栏收录该内容

352 篇文章

订阅专栏

本文详细介绍了Django模板系统的配置、变量与标签的使用方法、模板继承与包含技巧及过滤器的应用，帮助读者掌握高效利用Django进行网页开发的关键技能。

文章目录

1 模板引擎介绍和选择

模板具有一定的格式或骨架，可以动态的生成HTML
模板引擎决定以何种方式组织代码
一个项目可以有一个或者是多个模板引擎

Django支持：

DTL（Django Template Language）是django原生的模板系统
直到Django1.8，唯一的模板引擎支持

Jinja2介绍

速度更快，Python的功能齐全的开源模板引擎
安装
- pip install jinja2

没有模板引擎怎样在浏览器展示HTML?

从磁盘读取html字符串
将满足特定规则的内容进行替换
发送给浏览器展示

渲染机制：

步骤一：从磁盘读取模板文件（get_template）
步骤二：选择合适的模板引擎（select_template）
步骤三：将制定内容对模板进行渲染（render）
步骤四：发送给浏览器显示

为何要使用模板引擎?

代码的可阅读性
代码的可维护性
代码的可扩展性

2 Django模板相关配置

templates相关配置

配置示例

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
				# 其它选项配置
            ],
        },
    },
]

BACKEND——模板引擎配置

django.template.backends.django.DjangoTemplates
django.template.backends.jinja2.Jinja2

DIRS——模板引擎按列表顺序搜索这些目录以査找模板源文件
APP_DIRS——决定模板引擎是否应该进入每个已安装的应用中查找模板
- 每种模板引擎后端都定乂了一个惯用的名称作为应用内部存放模板
  的子目录名称
- DTL——templates目录
- Jinja2——jinja2目录
OPTIONS——其他选项配置

同时支持两种模板引擎：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': ['templates'],
    },
    {
        'BACKEND': 'django.template.backends.jinja2.Jinja2',
        'DIRS': [os.path.join(BASE_DIR, 'jinja2')],
    }
]

模板文件查找规则 get_template(“index.html”）
- templates/index.html
- jinja2/index.html

3 模板变量的使用

渲染 Python中的变量：

语法

{{variable}}
当模版引擎遇到一个变量，它将计算这个变量，然后用结果替换掉它本身
变量名称中不能有空格或标点符号，不能以“_“开头

views.py

from django.shortcuts import render


def index(request):
    username = '张三'
    age = 25

    return render(request, 'index.html',{
        'username': username,
        'age': age
    })

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>首页-DTL</h1>
    <p>用户名：{{ username }}</p>
    <p>年龄：{{ age }}</p>
</body>
</html>

渲染静态图片

图片地址的变量

img_url = '/media/images/dog.jpg'
模板文件中的渲染

<img src= "{{img_url}}" alt="可爱的狗"

from django.shortcuts import render


def index(request):
    username = '张三'
    age = 25
    img_url = '/media/dog.jpg'

    return render(request, 'index.html',{
        'username': username,
        'age': age,
        'img_url':img_url
    })

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>首页-DTL</h1>
    <p>用户名：{{ username }}</p>
    <p>年龄：{{ age }}</p>
    <img src="{{ img_url }}" alt="">
</body>
</html>

渲染 Python中的对象

语法

{{object.attribute}}
dict类型数据的渲染
list/tuple类型数据的渲染
list/tuple嵌套dict复杂类型数据的渲染

    list_users = [
        {'name':'张三','age':34},
        {'name':'李四','age':23}
    ]

{% for user in list_users %}
    <p>用户名：{{ user.name }}</p>
    <p>年龄：{{ user.age }}</p>
{% endfor %}

DTL与Jinja2的使用区别:

注意：变量名称中不能有空格或标点符号

下面的语法在DTL中不被支持

{{object["a.b"]}}
{{object["a b"]}}

user_obj = {
    'user name': '王五',
    'user.name': '万二麻子'
}

# 不支持
{#<p>{{ user_obj['user.name'] }}</p>#}

类中的成员方法调用不需要()，也不支持参数传递

class A():
    def display():
        return 'hello'
    
a = A()
{{ a.display }}

示例：

class Cat(object):

    def display(self):
        return '我是中华田园猫'

cat = Cat()

<h3>猫的信息</h3>
{{ cat.display }}

4 模板标签的使用

了解模板标签的作用
掌握常用的的模板标签
掌握DTL与 Jinja2的使用区别
语法

{% tag %}

循环控制

{% for item in data_list %}
<li>content</li>
{% empty %}
<li>content</li>
{% endfor %}

循环内的变量forloop

for循环dict

{% for key,value in data.items %}
	{{key}}:{{value}}
{% endfor %}

重复循环（循环中再循环）

{% cycle 'row1''row2' %}

与 Jinja2的区别

循环变量forloop，Jinja2为loop
List为空：{% empty %}，Jinja2中为{% else %}
循环中的再循环
- DTL：{% cycle 'odd''even' %}
- Jinja2：{{loop.cycle('odd','even')}}
DTL不支持 continue和 break

view.py

def tag(request):
    """ DTL的标签练习 """
    list_users = [
        {'name': '张三', 'age': 34},
        {'name': '李四', 'age': 23, 'sex': '男'},
        {'name': '张三2', 'age': 34},
        {'name': '李四2', 'age': 23},
    ]
    # list_users = []
    # reverse()
    return render(request, 'tag.html', {
        'list_users': list_users
    })

tag.html

<style type="text/css">
    .raw1 {
        color: #f00;
    }
    .raw2 {
        color: #00f;
    }
</style>

{% for user in list_users %}
<p class="{% cycle 'raw1' 'raw2' %}">第{{ forloop.counter }}个用户的信息
<br/>
    {# <p>用户名： {{ user.name }} </p>#}

    {% for key, value in user.items %}
    	{{ key }}: {{ value }}
    {% endfor %}

</p>
{% empty %}
	<p>暂无用户信息</p>
{% endfor %}

条件控制

语法参考

{% if condition_a %}
	满足了A条件
{% elif condition_b %}
	满足了B条件
{% else %}
	都不满足
{% endif %}

ifequal / ifnotequal

{% ifequal a b %}
...
{% endifequal %}

循环内ifchanged
其他控制逻辑
- and，or
- ==，！=
- >，<
- >=，<=
- in，not in
- is

模板注释

添加注释

{# 注释内容 #}


{% comment '简单的描述' %}
	<p> HTML内容{{create_date}}</p>
{% endcomment %}

与HTML注释的区别

<!--注释内容-->

URL解析

URL标签的使用

<a href="{% url 'index' %}">首页</a>

static静态文件URL解析

setting.py

STATIC_URL = '/static/'
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]

tag.html

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

与Jinja2的区别

DTL
- {% url 'url_name' params %}
Jinja2
- {{ url_for('index')}}

with语句块

语法参考

{% with alpha=1 beta=2 %}
...
{% endwith %}

当前时间显示

{% now "jS F Y H:i"%}

DTL与Jinja2的使用区别

区别一：循环中的区别
区别二：URL解析的区另

DTL与Jinja2大同小异，注意使用区别

5 模板的继承与包含

模板的抽象和继承

步骤一：将可变的部分圈出来（base.html）

{% block sidebar %}
	<!--菜单栏的内容-->
{% endblock %}

步骤二：继承父模板
```
{% extends "base.html"%}
```

步骤三：填充新的内容（index.html）

{% extends "base.html"%}

{% block sidebar %}
	<!--新的菜单栏中的内容-->
{% endblock %}

步骤四：复用父模板的內容（可选）

{% extends "base.html" %}
{% block sidebar %}
	{{block.super}}
	<!--新的菜单栏的内容-->
{% endblock %}

在模板中添加公共部分

步骤一：将可变的部分拆出来（footer.html）

<footer>
这是页脚公共的部分
</footer>

步骤二：将拆出来的部分包进来（index.html）

{% extends "base.html" %}
{% block content %}
	<!--页面主要内容区域-->

	{# 公用的footer #}
	{% include "footer.html" %}
{% endblock %}

6 模板过滤器

过滤器语法
```
{{value|filter_name:params}}
```
实例：使用过滤器将字母大写
```
{{value|upper}}
```

内置的过滤器

默认值显示

{{value|default:""}}
{{value|default_if_none:"无"}}}

数字四舍五入

{{value|floatformat:3}}

与Jinja2的区别

DTL语法
```
{{var|default:'我默认没有'}}
```
Jinja2语法
```
{{var|default('我默认没有')}}
```
日期对象格式化
```
{{value|date:"D d M Y"}}
```
时间对象格式化
```
{{value|time:"H:i"}}
```
富文本内容转义显示
```
{{value|safe}}
```

字符串截取

{{value|truncatechars:9}}
{{value|truncatechars_html:9}}
{{value|truncatewords:2}}

views.py

def test_filter(request):
    """ 过滤器的使用 """
    name = 'model'
    # list_user = []
    list_user = False
    user_info = None
    pi = 3.1415926
    my_date = datetime.datetime(2050, 9, 28)
    html = '<h3>欢迎学习我们的python课程，祝大家学习愉快</h3>'
    return render(request, 'test_filter.html', {
        'name': name,
        'list_user': list_user,
        'user_info': user_info,
        'pi': pi,
        'my_date': my_date,
        'html': html
    })

test_filter.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>过滤器的使用</title>
</head>
<body>
<p>
  {{ name }}-> {{ name|upper }}
</p>
<p>
  {{ list_user|default:'用户列表为空' }}
</p>
<p>
  {{ user_info|default_if_none:'用户信息为空' }}
</p>
<p>
  {{ pi }} -> {{ pi|floatformat:3 }}
</p>
<p>{{ my_date|date:'Y-m-d' }}</p>
<p>
  {{ html|safe }}
</p>
<p>{{ html|truncatechars:5 }}</p>
<p>{{ html|truncatechars_html:5|safe }}</p>
</body>
</html>