django 模板语言中的 extends，block 和 include

2023-10-01 09:47:28

一、extends使用方法

首先 extends 也就是继承，子类继承父类的一些特性。在django模板中通过继承可以减少重复代码。

首先我们建立一个app，名字叫做 hello。别忘了在 settings.py 中的 INSTALLED_APPS 注册这个app。不注册会出现 hello 目录下的 templates 中的模板无法调用。

1.在根目录下的 templates 创建 base.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}{% endblock %}</title>
</head>
<body>
{% block content %}
{% endblock %}
</body>
</html>

这里的 block 就是继承后要被替换的内容，其他的则与该模板相同.

2.在hello这个app中继承这个模板

在hello目录下新建templates目录，再在此目录下新建hello目录。hello目录中新建 hello.html。目录结构就像这样，理解一下django模板引用路径的规则

hello.html 内容如下

{% extends 'base.html' %}
{% block title %}{{ title }}{% endblock %}
{% block content %}{{ content }}{% endblock %}

首行代码就是先继承 base.html，也就是有了除了block的剩下内容。后面两个则是在为 block 填空，填入的内容是要传入的参数。这里分别是 title 和 content。这里可以看出模板语句是单个大括号加百分号，而模板变量是双大括号，没有百分号。

3.添加路由和方法

路由文件 urls.py 内容如下

from django.contrib import admin
from django.urls import path
from hello import views

urlpatterns = [
    path('hello/<str:title>/<str:content>/',views.hello),
    path('admin/', admin.site.urls),
]

注意在路径中获取参数的方法，str还可以换为int。我觉得这种传参的方法比较简单，还有正则表达式的传参方法。

views.py

from django.shortcuts import render

# Create your views here.
def hello(request,title,content):
    context={'title':title,'content':content}
    return render(request,'hello/hello.html',context)

这里函数的形参名就是在路由中获取的参数名。通过传递参数会render给hello.html这个模板，而hello.html这个模板又会继承base.html这个父模板。

实现效果如下

4.总结extends

通过 extends 可以减少代码重复。可以再增加header、footer等来包含共同的头部和底部内容。

include 要么放在 head 中，可以减少重复引入css或js，要么放在body中当一个共同的导航条，或者底部内容。

然而如果要在多处都 include 就不如直接用 extends 了。

二、include使用方法

这里我们在 hello 下新建 hello2.html 和 hello3.html。

hello2.html 内容如下

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>hello2</title>
</head>
<body>
{% include 'hello/hello3.html' %}
</body>
</html>

hello3.html 内容如下

<p>
    this is a p in hello3.html
</p>

可以看出，hello2.html 包含了 hello3.html 中的内容。这样也达到了减少重复代码的作用。再添加 views 中 hello2 方法

views.py

def hello2(request):
    return render(request,'hello/hello2.html')

以及 urls 中添加 hello2

urls.py

from django.contrib import admin
from django.urls import path
from hello import views

urlpatterns = [
    path('hello2/',views.hello2),
    path('hello/<str:title>/<str:content>/',views.hello),
    path('admin/', admin.site.urls),
]

实现效果如下

load

某些应用提供自定义标签和过滤器库。要在一个模板中访问它们, 使用 {% load %} 标签:
{% load comments %}
{% load %} 标签可接受空隔分隔的多个库的名字作为参数。{% load comments i18n %}
当载入一个自定义标签或过滤器库, 只有当前模板可以使用这些标签/过滤器 — 继承链中不论是父模板还是子模板都不能使用使用这些标签和过滤器。

{％load staticfiles％}
{％load static％}

在使用django的时候，加载静态文件时候，在index.html中输入
{% load staticfiles %}进行static在html中的声明
在加载static静态目录之时，则可以使用href='{% static 'css/reset.css' %}'

{% load staticfiles %} ### STATICFILES_DIRS
{% static 'css/style.css' %}

在一个网页中，不仅仅只有一个html骨架，还需要css样式文件，js执行文件以及一些图片等。因此在DTL中加载静态文件是一个必须要解决的问题。在DTL中，使用static标签来加载静态文件。要使用static标签，首先需要{% load static %}。加载静态文件的步骤如下：首先确保django.contrib.staticfiles已经添加到settings.INSTALLED_APPS中。确保在settings.py中设置了STATIC_URL。

For the moment (Django 1.9 and earlier), {% load staticfiles %} loads the static templatetag from the contrib app that has more features than the built-in django.core.static.

The most important difference is staticfiles can manage files stored on CDN, since its resolver can manage hashes for example. core.static only append STATIC_URL to the static filename, which is not enough if you're processing your files (e.g. adding md5 hash to clear cache between releases)

This difference is due to the fact that managing non-local storage files was not dedicated to be included in the core package of Django, but was still useful to many developers to be implemented as a official contrib package. So if you started to use staticfiles, you had to remember to use it every in your templates. BUT, some problems could appear, for example when using Media classes so the decision has been to merge those two templatetags into one and use a different behaviour whether the developer has django.contrib.staticfiles in its INSTALLED_APPS or not.

From Django 1.10 and onwards (also see ticket in Django tracker), the {% load static %} is going to use staticfiles internally if activated (oherwise keep default behaviour), and the templatetag in the contrib package will be deprecated to avoid confusion.

REF

https://www.cnblogs.com/roadwide/p/11318048.html

https://www.cnblogs.com/pinganzi/p/4825149.html

https://*.com/questions/34422971/load-static-and-load-staticfiles-which-is-preferred

https://blog.csdn.net/J_wb49/article/details/103055817

https://blog.csdn.net/xujin0/article/details/83421626

码农公寓