Django笔记&教程 3-1 模板(Template)基础
阅读原文时间:2022年04月07日阅读:1

Django 自学笔记兼学习教程第3章第1节——模板(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>

    <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 为所有模板引擎的设置的列表。列表中的每一项都是一个字典,其中包含单个引擎的选项。

其中:

  1. DIRS:模板文件目录(引擎将按顺序搜索查找)。

    如项目文件夹下新建模板文件夹templates,则必须在设置里面的DIRS里添加项目文件夹"templates/"

  2. APP_DIRS:默认为True,代表能够在已安装的应用程序(setting.py里的变量INSTALLED_APPS里的app)中查找模板源文件。

    所以在已安装的应用程序里,新建模板文件夹templates,在里面写模板文件,视图函数能够自动去找到对应的模板文件,是不用修改设置的。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器