首页 > 技术文章 > Django 视图层

51try-again 2019-06-23 16:50 原文

Django 视图层:

  1、URL映射

  2、视图函数

  3、模板

一、URL映射

1、普通 URL 映射

    URL 分发(URL dispatcher)映射配置可以被看作Django项目的入口配置,通过 URL dispatcher 可以指定用户每一次访问的后台Python处理函数是什么。

    每个Django项目都有一个urls.py文件用于维护 URL dispatcher, 对该文件的内容列举如下:

from django.urls import path
from django.conf.urls import url
from app import views

urlpatterns = [
    path('admin/', admin.site.urls),
    url(r'^year/([0-9]{4})/$', views.year_moments),
]

  该文件通过维护 urlpatterns 列表的元素完成URL的映射,每个元素可以是一个django.conf.urls.url() 函数的执行结果,也可以是 django.urls.path() 函数的结果。

  1. 两个函数的第一个参数是HTTP路径
  2. 第二个参数是该路径被映射到的Python函数名

  它们的区别在于:

    • url()函数的HTTP路径名是正则表达式
    • path()函数的HTTP路径是普通字符串

注意:

  1. 从Django 2.0开始,django.conf.urls.url() 是对 django.urls.re_path() 函数的简单封装,因此,也可以直接使用 django.urls.re_path();
  2. 若要从URL中捕获一个值作为Python函数的参数,只需在它周围放置一对圆括号,即正则表达式中的无名分组Python函数按照位置接受参数;
  3. 函数url()path()中的路径名不包括网站的主机名,开始不需要添加一个反斜杠
  4. 每个正则表达式前面的 'r' 是可选的但是建议加上。它告诉Python这个字符串是“原始的” --字符串中的任何字符串都不应该转义

Simplified URL routing syntax

# The new django.urls.path() function allows a simpler, more readable URL routing syntax. For example, this example from previous Django releases:

url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
could be written as:

path('articles/<int:year>/', views.year_archive),
# The new syntax supports type coercion of URL parameters. 
# In the example, the view will receive the year keyword argument as an integer rather than as a string. 
# Also, the URLs that will match are slightly less constrained in the rewritten example. 
# For example, the year 10000 will now match since the year integers aren’t constrained to be exactly four digits long as they are in the regular expression.

# The django.conf.urls.url() function from previous versions is now available as django.urls.re_path(). 
# The old location remains for backwards compatibility, without an imminent deprecation. 
# The old django.conf.urls.include() function is now importable from django.urls so you can use from django.urls import include, path, re_path in your URLconfs.

# The URL dispatcher document is rewritten to feature the new syntax and provide more details.

2、命名URL参数映射

  在普通URL映射中,Django将URL中的变量参数按照路径中出现的顺序传递给被调函数。而命名的URL参数映射使得开发者可以定义这些被传递参数的名称,命名URL参数的定义方式是 命名的正则表达式组----->“?P<param_name>pattern” ;

  在Python 正则表达式中,命名正则表达式组的语法是(?P<name>pattern),

    • 其中name 是组的名称,
    • pattern 是要匹配的模式。
from django.urls import path, re_path
from django.conf.urls import url

urlpatterns = [
    path('year/2018/', views.year_moments),
    url(r'^year/(?P<year>[0-9]{4})/$', views.year_moments),
    url(r'^month/(?P<year>\d{4})/(?P<month>\d{2})/$', views.month_moments),
]

后面两个url()个使用命名参数进行定义,它们调用 views.py中的Python函数,其中前两个调用方式分别为:

    • year_moments(request, year= xxxx) 
    • month_moments(request, year=xxxx, month=xx).

 3、分布式URL映射(路由分发)

  在大型Django项目中,一个项目可能包含多个Django应用,而每个应用都有自己的URL映射规则。这时把所有的URL映射都保存在一个urls.py文件中就不利于网站的维护,所以Django用include()函数提供了分布式URL映射的功能,使得URL映射可以被编写在多个urls.py文件中。

from django.contrib import admin
from django.urls import path, re_path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('app01/', include("app01.urls")),
]

 4、反向解析

  除了上述从 HTTP URL 映射到 Python视图函数的丰富的映射功能,Django 还提供了反向的从 映射名URL地址 的解析功能。URL 反向解析使得开发者可以用映射名代替许多需要写绝对 URL 路径的地方,提供了代码的可维护性。

Django 的 URL 反向解析功能在 模板文件 Python 程序中有不同的调用方法:

    • 在模板文件中用 {% url %} 标签调用方向解析;
    • 在Python程序中用 django.urls.reverse() 函数调用反向解析

urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    path('login/', views.login, name="Login"),
]

模板文件中 login.html

<form action="{% url 'Login' %}" method="post">
    <p>用户名:<input type="text" name="user"></p>
    <p>密码:<input type="password" name="pwd"></p>
    <input type="submit">
</form>

Python 程序中views.py

from django.shortcuts import render, HttpResponse, redirect
from django.urls import reverse


def login(request):
    
    if request.method == "POST":
        username = request.POST.get("user")
        pwd = request.POST.get("pwd")
        if username == "root" and pwd == "adminstator":
            return redirect(reverse("Index"))
        
    return render(request, "login.html")

5、名称空间

  命名空间(英语:Namespace)是表示标识符的可见范围。一个标识符可在多个命名空间中定义,它在不同命名空间中的含义是互不相干的。

这样,在一个新的命名空间中可定义任何标识符,它们不会与任何已有的标识符发生冲突,因为已有的定义都处于其它命名空间中。

由于name没有作用域,Django在反解URL时,会在项目全局顺序搜索,当查找到第一个name指定URL时,立即返回。
我们在开发项目时,会经常使用name属性反解出URL,当不小心在不同的app的urls中定义相同的name时,可能会导致URL反解错误,为了避免这种事情发生,引入了命名空间。
 
project的urls.py
urlpatterns = [
    re_path(r'^admin/', admin.site.urls),
    path('app01/', include(("app01.urls", "app01"), namespace="app01")),
]

app01.urls

urlpatterns = [
    re_path(r'^index/', views.index, name="index"),
]

app01.views

<form action="{% url 'app01:Login' %}" method="post">
    <p>用户名:<input type="text" name="user"></p>
    <p>密码:<input type="password" name="pwd"></p>
    <input type="submit">
</form>

Python 程序中views.py

from django.shortcuts import render, HttpResponse, redirect
from django.urls import reverse


def login(request):
    
    if request.method == "POST":
        username = request.POST.get("user")
        pwd = request.POST.get("pwd")
        if username == "root" and pwd == "adminstator":
            return redirect(reverse("app01:index"))
        
    return render(request, "login.html")

二、视图层

  视图函数是 Django 开发者处理 HTTP 请求的 Python 函数。在通常情况下,视图函数的功能是通过模型层对象处理数据,然后用如下方式中的一种返回 HTTP Response.

  • 直接构造 HTTP Body
  • 用数据渲染 HTML 模板文件
  • 如果有逻辑错误,则返回HTTP 错误 或 其他状态

1、直接构造 HTML 页面

from django.shortcuts import HttpResponse
import datetime

def current_datetime(request):
    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M%S")
    html = "<h3>现在时刻: now %s</h3>" % now
    return HttpResponse(html)
  • 首先,我们从 django.shortcuts模块导入了HttpResponse类,以及Python的datetime库。
  • 接着,我们定义了current_datetime函数。它就是视图函数。每个视图函数都使用HttpRequest对象作为第一个参数,并且通常称之为request
    • 注意:视图函数的名称并不重要;不需要用一个统一的命名方式来命名。我们将其命名为current_datetime,是因为这个名称能够精确地反映出它的功能。

  • 这个视图会返回一个HttpResponse对象,其中包含生成的响应。每个视图函数都负责返回一个HttpResponse对象。

2、用数据渲染HTML模板文件

  由于模板文件可以包含丰富的HTML内容,因此使用渲染模板文件的方法返回页面是最常见的的一种Django视图函数的技术。渲染模板通过render() 函数实现。

from django.shortcuts import render
from app.models import Author, Publish

def add_book(request):
    if request.method == 'GET':
        authors_list = models.Author.objects.all()
        publish_list = models.Publish.objects.all()

        return render(request, 'add_book.html',{'authors_list': authors_list, 'publish_list': publish_list})

  函数 render() 的第一个参数是 HTTP request, 第二个参数是模板文件名,第三个参数是字典形式表达的模板参数

3、返回HTTP错误

  HTTP 错误通过 HTTP 头中的 Status 表达,通过给 HttpResponse 构造函数传递 status 参数,可以返回 HTTP 错误或 状态。比如:

from django.http import HttpResponse

def show_view(request):
     return HttpResponse(status=404)

  通过上述代码可返回 HTTP 404 错误,即 “Page Not Found”。为了方便开发者, Django 对于常用的 Status 状态定义了若干 HttpResponse 的子类,开发者需要返回非 200 OK状态时,也可直接通过这些子类定义 Response,比如:下面是用 HttpResponseNotFound 子类的实例返回 404 错误:

from django.http import HttpResponseNotFound

def show_view(request):
    return HttpResponseNotFound()

  其他一些常用的特定状态 HttpResponse子类如下:

# 返回 Status 301, 和 HttpResponseRedirect类似,告诉浏览器这是一个永久的重定向
class HttpResponsePermanentRedirect(HttpResponseRedirectBase):
    status_code = 301

# 返回 Status 302, 用于 URL 重定向,需要将重定向的目标地址作为参数传给该类
class HttpResponseRedirect(HttpResponseRedirectBase):
    status_code = 302

# 返回 Status 304, 用于指示浏览器用上次请求时的缓存结果作为页面内容显示
class HttpResponseNotModified(HttpResponse):
    status_code = 304

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        del self['content-type']

    @HttpResponse.content.setter
    def content(self, value):
        if value:
            raise AttributeError("You cannot set content to a 304 (Not Modified) response")
        self._container = []


# 返回 Status 400, 请求内容错误
class HttpResponseBadRequest(HttpResponse):
    status_code = 400

# 返回 Status 403, 禁止访问错误
class HttpResponseForbidden(HttpResponse):
    status_code = 403

class HttpResponseNotFound(HttpResponse):
    status_code = 404

# 返回 Status 405, 用不允许的方法(GET、POST、HEAD等) 访问本页面
class HttpResponseNotAllowed(HttpResponse):
    status_code = 405

    def __init__(self, permitted_methods, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self['Allow'] = ', '.join(permitted_methods)

    def __repr__(self):
        return '<%(cls)s [%(methods)s] status_code=%(status_code)d%(content_type)s>' % {
            'cls': self.__class__.__name__,
            'status_code': self.status_code,
            'content_type': self._content_type_for_repr,
            'methods': self['Allow'],
        }

# 返回 Status 410, 被请求的资源在服务器上已经不再可用
class HttpResponseGone(HttpResponse):
    status_code = 410

# 返回 Status 500, 服务器内部错误,比如无法处理的异常等
class HttpResponseServerError(HttpResponse):
    status_code = 500

  

视图层,熟练掌握两个对象即可:请求对象(request)和响应对象(HttpResponse)

1、HttpRequest对象

  • request属性  ---->  django将请求报文中的请求行、首部信息、内容主体封装成 HttpRequest 类中的属性。 除了特殊说明的之外,其他均为只读的。
1.HttpRequest.GET

  一个类似于字典的对象,包含 HTTP GET 的所有参数。详情请参考 QueryDict 对象。

2.HttpRequest.POST

  一个类似于字典的对象,如果请求中包含表单数据,则将这些数据封装成 QueryDict 对象。

  POST 请求可以带有空的 POST 字典 —— 如果通过 HTTP POST 方法发送一个表单,但是表单中没有任何的数据,QueryDict 对象依然会被创建。
   因此,不应该使用 if request.POST  来检查使用的是否是POST 方法;应该使用 if request.method == "POST"
  另外:如果使用 POST 上传文件的话,文件信息将包含在 FILES 属性中。
   
   注意:键值对的值是多个的时候,比如checkbox类型的input标签,select标签,需要用:
        request.POST.getlist("hobby")

3.HttpRequest.body

  一个字符串,代表请求报文的主体。在处理非 HTTP 形式的报文时非常有用,例如:二进制图片、XML,Json等。
  但是,如果要处理表单数据的时候,推荐还是使用 HttpRequest.POST 。


4.HttpRequest.path

  一个字符串,表示请求的路径组件(不含域名)。
  例如:"/music/bands/the_beatles/"

5.HttpRequest.method

  一个字符串,表示请求使用的HTTP 方法。必须使用大写。
  例如:"GET"、"POST"


6.HttpRequest.encoding

  一个字符串,表示提交的数据的编码方式(如果为 None 则表示使用 DEFAULT_CHARSET 的设置,默认为 'utf-8')。
   这个属性是可写的,你可以修改它来修改访问表单数据使用的编码。
   接下来对属性的任何访问(例如从 GET 或 POST 中读取数据)将使用新的 encoding 值。
   如果你知道表单数据的编码不是 DEFAULT_CHARSET ,则使用它。


7.HttpRequest.META

   一个标准的Python 字典,包含所有的HTTP 首部。具体的头部信息取决于客户端和服务器,下面是一些示例:

    CONTENT_LENGTH —— 请求的正文的长度(是一个字符串)。
    CONTENT_TYPE —— 请求的正文的MIME 类型。
    HTTP_ACCEPT —— 响应可接收的Content-Type。
    HTTP_ACCEPT_ENCODING —— 响应可接收的编码。
    HTTP_ACCEPT_LANGUAGE —— 响应可接收的语言。
    HTTP_HOST —— 客服端发送的HTTP Host 头部。
    HTTP_REFERER —— Referring 页面。
    HTTP_USER_AGENT —— 客户端的user-agent 字符串。
    QUERY_STRING —— 单个字符串形式的查询字符串(未解析过的形式)。
    REMOTE_ADDR —— 客户端的IP 地址。
    REMOTE_HOST —— 客户端的主机名。
    REMOTE_USER —— 服务器认证后的用户。
    REQUEST_METHOD —— 一个字符串,例如"GET" 或"POST"。
    SERVER_NAME —— 服务器的主机名。
    SERVER_PORT —— 服务器的端口(是一个字符串)。
   从上面可以看到,除 CONTENT_LENGTH 和 CONTENT_TYPE 之外,请求中的任何 HTTP 首部转换为 META 的键时,
    都会将所有字母大写并将连接符替换为下划线最后加上 HTTP_  前缀。
    所以,一个叫做 X-Bender 的头部将转换成 META 中的 HTTP_X_BENDER 键。

8.HttpRequest.FILES

  一个类似于字典的对象,包含所有的上传文件信息。
   FILES 中的每个键为<input type="file" name="" /> 中的name,值则为对应的数据。
  注意,FILES 只有在请求的方法为POST 且提交的<form> 带有enctype="multipart/form-data" 的情况下才会
   包含数据。否则,FILES 将为一个空的类似于字典的对象。


9.HttpRequest.COOKIES

  一个标准的Python 字典,包含所有的cookie。键和值都为字符串。


10.HttpRequest.session

   一个既可读又可写的类似于字典的对象,表示当前的会话。只有当Django 启用会话的支持时才可用。
    完整的细节参见会话的文档。


11.HttpRequest.user(用户认证组件下使用)

  一个 AUTH_USER_MODEL 类型的对象,表示当前登录的用户。

  如果用户当前没有登录,user 将设置为 django.contrib.auth.models.AnonymousUser 的一个实例。你可以通过 is_authenticated() 区分它们。

    例如:

    if request.user.is_authenticated():
        # Do something for logged-in users.
    else:
        # Do something for anonymous users.


       user 只有当Django 启用 AuthenticationMiddleware 中间件时才可用。

     -------------------------------------------------------------------------------------

    匿名用户
    class models.AnonymousUser

    django.contrib.auth.models.AnonymousUser 类实现了django.contrib.auth.models.User 接口,但具有下面几个不同点:

    id 永远为None。
    username 永远为空字符串。
    get_username() 永远返回空字符串。
    is_staff 和 is_superuser 永远为False。
    is_active 永远为 False。
    groups 和 user_permissions 永远为空。
    is_anonymous() 返回True 而不是False。
    is_authenticated() 返回False 而不是True。
    set_password()、check_password()、save() 和delete() 引发 NotImplementedError。
    New in Django 1.8:
    新增 AnonymousUser.get_username() 以更好地模拟 django.contrib.auth.models.User。
  • request常用方法
1.HttpRequest.get_full_path()

  返回 path,如果可以将加上查询字符串。

  例如:"/music/bands/the_beatles/?print=true"


2.HttpRequest.is_ajax()

  如果请求是通过XMLHttpRequest 发起的,则返回True,方法是检查 HTTP_X_REQUESTED_WITH 相应的首部是否是字符串'XMLHttpRequest'。

  大部分现代的 JavaScript 库都会发送这个头部。如果你编写自己的 XMLHttpRequest 调用(在浏览器端),你必须手工设置这个值来让 is_ajax() 可以工作。

  如果一个响应需要根据请求是否是通过AJAX 发起的,并且你正在使用某种形式的缓存例如Django 的 cache middleware,
   你应该使用 vary_on_headers('HTTP_X_REQUESTED_WITH') 装饰你的视图以让响应能够正确地缓存。

2、HttpResponse对象

响应对象主要有三种形式:

  • HttpResponse()
  • render()
  • redirect()

HttpResponse()括号内直接跟一个具体的字符串作为响应体,比较直接很简单,所以这里主要介绍后面两种形式。

a、render方法

# 结合一个给定的模板和一个给定的上下文字典,并返回一个渲染后的 HttpResponse 对象。
render(request, template_name[, context])

    参数:

    • request: 用于生成响应的请求对象。
    • template_name:要使用的模板的完整名称,可选的参数
    • context:添加到模板上下文的一个字典。默认是一个空字典。如果字典中的某个值是可调用的,视图将在渲染模板之前调用它。
    • render方法 就是将一个模板页面中的模板语法进行渲染,最终渲染成一个html页面作为响应体。
b、redirect方法
  • 传递要重定向的一个硬编码的URL
def music_view(request):
    ...
    return redirect('/some/url/')
  • 也可以是一个完整的URL
def music_view(request):
    ...
    return redirect('http://example.com/') 
两种重定向请求
1)301和302的区别

  301和302状态码都表示重定向,就是说浏览器在拿到服务器返回的这个状态码后会自动跳转到一个新的URL地址,这个地址可以从响应的Location首部中获取
  (用户看到的效果就是他输入的地址A瞬间变成了另一个地址B)——这是它们的共同点。

  他们的不同在于。301表示旧地址A的资源已经被永久地移除了(这个资源不可访问了),搜索引擎在抓取新内容的同时也将旧的网址交换为重定向之后的网址;

  302表示旧地址A的资源还在(仍然可以访问),这个重定向只是临时地从旧地址A跳转到地址B,搜索引擎会抓取新的内容而保存旧的网址。 SEO302好于301

 
2)重定向原因:
(1)网站调整(如改变网页目录结构);
(2)网页被移到一个新地址;
(3)网页扩展名改变(如应用需要把.php改成.Html或.shtml)。
        这种情况下,如果不做重定向,则用户收藏夹或搜索引擎数据库中旧地址只能让访问客户得到一个404页面错误信息,访问流量白白丧失;再者某些注册了多个域名的
    网站,也需要通过重定向让访问这些域名的用户自动跳转到主站点等。

三、模板层

  模板文件是一个文本文件,模板文件主要由于目标文件的内容(比如 HTML、CSS等),辅以模板文件的特殊语法用于特换动态内容。下面是一个功能较全的典型模板文件:

{% extends 'base.html' %}

{% block title %}{{ section.title }}{% endblock %}    {# 块内容,用于模板 继承#}

{% block content %}                                   {# 块内容,用于模板 继承#}
    <h1>{{ section.name }}</h1>                       {# 变量替换#}
    
    {% for mement in moment_list %}                   {# 流程控制语句#}
        {{ moment.headline | upper }}                 {# 带过滤器的变量替换#}
    {% endfor %}
{% endblock %}

1、模板语法之变量

  用双大括号标记 {{ variable }}  指示变量内容替换,只需在其中写入变量名即可

2、模板语法之过滤器

  过滤器(filter)在模板中是放在 变量后 用于控制变量 显示格式 的技术。变量与过滤器之间通过 管道符号 “|” 连接。语法:

{{obj | filter__name : param}}

常见的过滤器:

length
# 返回值的长度。它对字符串和列表都起作用。例如:
{{ value|length }}
#如果 value 是 ['a', 'b', 'c', 'd'],那么输出是 4。

filesizeformat # 将值格式化为一个 “人类可读的” 文件尺寸 (例如 '13 KB', '4.1 MB', '102 bytes', 等等)。例如: {{ value|filesizeformat }} # 如果 value 是 123456789,输出将会是 117.7 MB。
date # 如果 value=datetime.datetime.now() {{ value|date:"Y-m-d" }} 
truncatechars # 如果字符串字符多于指定的字符数量,那么会被截断。截断的字符串将以可翻译的省略号序列(“...”)结尾。 #参数:要截断的字符数,例如: {{ value|truncatechars:10 }}
safe # Django的模板中会对HTML标签和JS等语法标签进行自动转义,原因显而易见,这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义,比如我们做一个内容管理系统,后台添加的文章中是经过修饰的,这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本,如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式,如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。比如: value="<a href="">点击</a>" {{ value|safe }}

3、模板之标签

  标签看起来像是这样的: {% tag %}。标签比变量更加复杂:

  • 一些在输出中创建文本,
  • 一些通过循环或逻辑来控制流程,
  • 一些加载其后的变量将使用到的额外信息到模版中。
  • 一些标签需要开始和结束标签 (例如{% tag %} ...标签 内容 ... {% endtag %})。
for标签
# 遍历每一个元素:
{% 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 %}

#注:循环序号可以通过{{forloop}}显示   forloop.counter The current iteration of the loop (1-indexed) forloop.counter0 The current iteration of the loop (0-indexed) forloop.revcounter The number of iterations from the end of the loop (1-indexed) forloop.revcounter0 The number of iterations from the end of the loop (0-indexed) forloop.first True if this is the first time through the loop forloop.last True if this is the last time through the loop for ... empty

# for 标签带有一个可选的{% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。 {% for person in person_list %} <p>{{ person.name }}</p> {% empty %} <p>sorry,no person here</p> {% endfor %}
# if 标签 {% if %}会对一个变量求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),对应的内容块会输出。 {% if num > 100 or num < 0 %} <p>无效</p> {% elif num > 80 and num < 100 %} <p>优秀</p> {% else %} <p>凑活吧</p> {% endif %} # with # 使用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的。例如: {% with total=business.employees.count %} {{ total }} employee{{ total|pluralize }} {% endwith %}

# csrf_token # 这个标签用于跨站请求伪造保护 

4、自定义标签和过滤器

  1. settings中的INSTALLED_APPS配置当前app,不然django无法找到自定义的simple_tag.
  2. 在app中创建templatetags模块(模块名只能是templatetags)
  3. 创建任意 .py 文件,如:my_tags.py
{% load my_tags %} 

  4. 在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py

  5. 使用simple_tag和filter(如何调用)

5、模板继承 (extend)

  Django模版引擎中最强大也是最复杂的部分就是模版继承了。模版继承可以让您创建一个基本的“骨架”模版,它包含您站点中的全部元素,并且可以定义能够被子模版覆盖的 blocks 

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css" />
    <title>{% block title %}My Django site{% endblock %}</title>
</head>

<body>
    <div id="sidebar">
        {% block sidebar %}
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/project/">Project</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
        {% endblock %}
    </div>

    <div id="content">
        {% block content %}
        {% endblock %}
    </div>
</body>
</html>        

  这个模版,我们把它叫作 base.html, 它定义了一个可以用于两列排版页面的简单HTML骨架。“子模版”的工作是用它们的内容填充空的blocks。

  在这个例子中, block 标签定义了三个可以被子模版内容填充的block。

   block 告诉模版引擎: 子模版可能会覆盖掉模版中的这些位置。

子模版可能看起来是这样的:

{% extends "base.html" %}
 
{% block title %}My amazing blog{% endblock %}
 
{% block content %}
Here is child file content that wil show in result.
{% endblock %}

  extends 标签是这里的关键。它告诉模版引擎,这个模版“继承”了另一个模版。当模版系统处理这个模版时,首先,它将定位父模版——在此例中,就是“base.html”。

  那时,模版引擎将注意到 base.html 中的三个 block 标签,并用子模版中的内容来替换这些 block

  这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航。

  使用继承的一些提示:

如果你在模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况下,模版继承都将无法工作。

在base模版中设置越多的 {% block %} 标签越好。请记住,子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的默认内容,然后,只定义你需要的那一个。多一点钩子总比少一点好。

如果你发现你自己在大量的模版中复制内容,那可能意味着你应该把内容移动到父模版中的一个 {% block %} 中。

If you need to get the content of the block from the parent template, the {{ block.super }} variable will do the trick. This is useful if you want to add to the contents of a parent block instead of completely overriding it. Data inserted using {{ block.super }} will not be automatically escaped (see the next section), since it was already escaped, if necessary, in the parent template.
不能在一个模版中定义多个相同名字的 block 标签。

为了更好的可读性,你也可以给你的 {% endblock %} 标签一个 名字 。例如:
  在大型模版中,这个方法帮你清楚的看到哪一个  {% block %} 标签被关闭了。

推荐阅读