Python框架篇之Django（Template模版：标签tag、自定义filter、extend模板继承）

不念不忘少年蓝@ 2023-02-20 13:49 119阅读 0赞

### 文章目录 ###

*   *   *   *  一、标签的使用（tag）
             *  二、自定义filter和simple\_tag
             *  三、extend模板继承

#### 一、标签的使用（tag） ####

**1、语法格式：**`{% tags %}`

**2、提供的几种标签**

*  \{% if %\}：计算一个变量值，如果是“true”，即它存在、不为空并且不是false的boolean值,系统则会显示\{% if %\}和\{% endif %\}间的所有内容

{ % if ani.age > 25 %}
        <h1>{ {  ani.name }},you have a lot of responsibilities！</h1>
    { % elif ani.age >= 18 %}
        <h1>{ {  ani.name }},you have been an adult！</h1>
    { % else %}
        <h1>You just a child!</h1>
    { % endif %}

*  \{% for %\}：允许你按顺序遍历一个序列中的各个元素,每次循环模板系统都会渲染\{% for %\}和\{% endfor %\}之间的所有内容

{ #for循环#}
    { #注意：for是没有办法拿到索引的，只能用forloop.counter来拿#}
    { % for name in li %}
        <h3>{ {  forloop.counter }}：{ {  name }}</h3> <h4>{ {  forloop.revcounter }}：{ {  name }}</h4>
    { % endfor %}
    
    { % for name in li %}
        { % if forloop.first %}
    { #        创建一个列表标签，并且带有class为first的标签背景色变红#}
            <li class="first">
        { % else %}
            <li>
        { % endif %}
            { {  name }}
        </li>
        { % empty %}
            <h1>没有相关文章！</h1>
    { % endfor %}

*  \{%csrf\_token%\}：用于生成csrf\_token的标签，用于防治跨站攻击验证。
 *  \{% url %\}：引用路由配置的地址

{ #{ % url  %}引用路由配置地址#}
    <form action="{ % url 'login' %}" method="post"> <p>账号：<input type="text"></p> <p>密码：<input type="text"></p> <p><input type="submit"></p>
        { % csrf_token %}
    { #    一种Django的安全机制，相当于给页面加上了一个身份证——一串编码，有了这个才可以正常跳转到url 'login'页面#}
    </form>

*  \{% with %\}：用更简单的变量名替代复杂的变量名

{ % with total=fhjsaldfhjsdfhlasdfhljsdal %} { {  total }} { % endwith %}

*  \{% verbatim %\}：禁止render

{ % verbatim %}
             { {  hello }}
    { % endverbatim %}

*  \{% load %\}: 加载标签库

#### 二、自定义filter和simple\_tag ####

**1、自定义filter过滤器**

*  a、首先在app中创建templatetags模块
 *  b、然后创建任意 .py 文件，如：myTag.py
 *  c、套用引用代码：

from django import template
    from django.utils.safestring import mark_safe
    
    register = template.Library()   #register的名字是固定的,不可改变

*  d、编写自定义的函数  
    ![11][]
 *  e、在使用自定义simple\_tag和filter的html文件中导入之前创建的 my\_tags.py ：\{% load my\_tags %\}
 *  f、在html中调用：由于filter函数只接收两个参数，因此此处只能传入一个参数，可以是列表、字典

<h1>filter：{ {  ani.age|filter_muti:3 }}</h1>

**2、自定义simple\_tag：**  
**可以传任意个参数**，用空格隔开  
simple\_tag\_muti函数已经在上图展示了，这里直接调用

<h1>simple_tae：{ % simple_tag_muti 26 2 10%}</h1>

**3、注意：**

*  a、在settings中的INSTALLED\_APPS配置当前app，不然django无法找到自定义的simple\_tag
 *  b、filter可以用在if等控制语句后，simple\_tag不可以

{ % if num|filter_multi:30 > 100 %}
        { {  num|filter_multi:30 }}
    { % endif %}

#### 三、extend模板继承 ####

**1、include 模板标签**  
该标签允许在（模板中）包含其它的模板的内容。 标签的参数是所要包含的模板名称，可以是一个变量，也可以是用单/双引号硬编码的字符串。 每当在多个模板中出现相同的代码时，就应该考虑是否要使用 \{% include %\} 来减少重复。

**2、extend继承模板标签**  
在整个网站中，如何减少共用页面区域（比如站点导航）所引起的重复和冗余代码？  
比如，如果有一个更典型的网站，它有导航条、样式表，可能还有一些 JavaScript 代码，事情必将以向每个模板填充各种冗余的 HTML 而效率低下。  
传统解决方法是使用 服务器端的 includes ，你可以在 HTML 页面中使用该指令将一个网页嵌入到另一个中。 事实上， Django 通过刚才讲述的 \{% include %\} 支持了这种方法。

**3、extend 的本质**  
模板继承就是先构造一个基础框架模板，而后在其子模板中对它所包含站点公用部分和定义块进行重载。

**4、继承的步骤**  
（1） 创建 base.html 模板，在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。  
（2） 为网站的每个区域创建 base\_SECTION.html 模板(例如, base\_photos.html 和 base\_forum.html )。这些模板对base.html 进行拓展，并包含区域特定的风格与设计。  
（3）为每种类型的页面创建独立的模板，例如论坛页面或者图片库。 这些模板拓展相应的区域模板。  
这个方法可最大限度地重用代码，并使得向公共区域（如区域级的导航）添加内容成为一件轻松的工作

5、继承后的修改

{ #继承base.html#}
    { % extends 'base.html' %}
    
    { #修改样式：前提是base里面也必须有{ % block style %}#}
    { % block styles %}
        <style>
            h2{ 
                background-color: yellowgreen;
            }
        </style>
    { % endblock %}
    
    { #但是有一部分需要修改，则只能改{ {  block  }}里的内容#}
    { % block content %}
    { #    获取父类#}
        { {  block.super }}
    
        { % for s in student_list %}
            <h2>学生{ {  s }}</h2>
        { % endfor %}
    { % endblock %}

![22][]

**6、extend继承注意**

*  如果在模板中使用 \{% extends %\} ，必须保证其为模板中的第一个模板标记。 否则，模板继承将不起作用。
 *  一般来说，基础模板中的 \{% block %\} 标签越多越好。 记住，子模板不必定义父模板中所有的代码块，因此你可以用合理的缺省值对一些代码块进行填充，然后只对子模板所需的代码块进行（重）定义。
 *  如果发觉自己在多个模板之间拷贝代码，你应该考虑将该代码段放置到父模板的某个 \{% block %\} 中。  
    如果你需要访问父模板中的块的内容，使用 \{ \{ block.super \}\}这个标签吧，这一个魔法变量将会表现出父模板中的内容。 如果只想在上级代码块基础上添加内容，而不是全部重载，该变量就显得非常有用了。
 *  不允许在同一个模板中定义多个同名的 \{% block %\} 。 存在这样的限制是因为block 标签的工作方式是双向的。  
    也就是说，block 标签不仅挖了一个要填的坑，也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 \{% block %\} 标签，父模板将无从得知要使用哪个块的内容。

[11]: https://img-blog.csdnimg.cn/20200627193248426.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZpZXdpbmZpbml0ZWx5,size_16,color_FFFFFF,t_70
[22]: https://img-blog.csdnimg.cn/2020062719493014.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZpZXdpbmZpbml0ZWx5,size_16,color_FFFFFF,t_70