Django自学笔记 3-1 模板（Template）基础-优快云博客

————总目录——前言——框架版本————

======================= 大爽歌作，made by big shuang =======================

一、模板（Template）基础

1 介绍

模板文件：让Django能够自动生成html代码

作为一个web框架，Django需要需要在html页面里展示python变量值或使用python代码
直接在html里面写入python代码是不行的，所以需要一种方便的方式（根据python变量或python代码）来动态生成HTML。
最常见的方法是使用模板。

注：想要弄懂模板，必须先懂点HTML，不用精通，认识和了解html基础语法、代码结构、相关概念就可以了，

2 代码示例

background.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>
        学生选课管理系统
    </title>
</head>
<body>
<div class="main-container">
    <div class="main-header">
        <div class="main-title">学生选课管理系统</div>
        <div class="sub-title">Student Course Management System</div>
        {% block welcome_message %}
        {% endblock %}
    </div>
    <div class="login-container">
        {% block login_container %}
        {% endblock %}
    </div>
</div>
</body>
</html>

login_home.html

{% extends "user/background.html" %}
{% block login_container %}
<div class="login-kind student-login-button">
    <a href="">学生登录</a>
</div>
<div class="login-kind teacher-login-button">
    <a href="">教师登录</a>
</div>
{% endblock %}

这里我们先不急着弄懂里面每行的意思，先观察一下模板（Template）html和普通的html有什么区别。

懂一点html的话，我们就会发现，模板（Template）里面多了一些这样的语句，这在html中是没有的

{% block welcome_message %}
{% endblock %}

{% block login_container %}
{% endblock %}

{% extends "user/background.html" %}
{% block login_container %}
{% endblock %}

这样的语句有什么特点呢。其写法是{%符号开头，以%}符号结尾，这两个符号和内部的文本用空格相隔。

这是Django模板语言的一种Tags（标签）语法，
Django模板语言的几种语法我们将在本章第二节做大类介绍，第三节做具体的介绍。

3 视图调用与传参

本文第二部分展示了一个模板的示例。
但是该模板要在前端展示出来，绝不是通过直接请求html对应的文件路径url来获得的。
而是要通过视图函数渲出来。

这里举个实例，本文第二部分的login_home.html在项目中的相对路径为
templates/user/login_home.html，用视图函数渲染这个模板，一个简单的写法如下

# views.py
from django.shortcuts import render

def home(request):
    return render(request, "user/login_home.html")

访问一个会调用该视图函数的url，即可得到渲染后的login_home.html如下图。

渲染模板的语法十分简单：
先从django.shortcuts中导入render方法
调用render方法，
第一个参数为视图函数接受的请求对象request，
第二个参数为模板文件的在模板文件夹下的相对路径，在上面的例子中是"user/login_home.html"。

这里我们举得例子是一个不用往模板中传入变量的例子。
但实际上，模板的设计就是让我们能够在里面展示python变量值或使用python代码。

所以往模板里面传入变量是一个基础操作，这个时候需要设置render里面的context变量，这是一个字典变量。
context变量的键是模板中能够直接使用的变量名，对应的值即是变量的值。
举个例子，需要往里面传入变量name，

# views.py
from django.shortcuts import render

def home(request):
    my_name = "Big Shuang"
    context = {
        "name": my_name
    }
    return render(request, "user/login_home.html", context)

在模板中要是用"Big Shuang"这个值，可以直接调用name这个变量。
只不过语法上还有点要求，一般在模板中会写成{{ name }}这样来调用视图中传入的变量。
具体模板的语法会在后面几个小节展开去说。

4 模板设置

参考目录：https://docs.djangoproject.com/en/2.2/ref/settings/#std:setting-TEMPLATES

模板的设置在setting.py变量TEMPLATES 里，默认值如下：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        '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',
            ],
        },
    },
]

变量TEMPLATES 为所有模板引擎的设置的列表。列表中的每一项都是一个字典，其中包含单个引擎的选项。
其中：

DIRS：模板文件目录（引擎将按顺序搜索查找）。
如项目文件夹下新建模板文件夹templates，则必须在设置里面的DIRS里添加项目文件夹"templates/"
APP_DIRS：默认为True，代表能够在已安装的应用程序（setting.py里的变量INSTALLED_APPS里的app）中查找模板源文件。
所以在已安装的应用程序里，新建模板文件夹templates，在里面写模板文件，视图函数能够自动去找到对应的模板文件，是不用修改设置的。