• Django的模板层


      在前面的学习中注意到在例子视图中返回文本的方式有点特别。 也就是说,HTML被直接硬编码在 Python代码之中。

    def current_datetime(request):
        now = datetime.datetime.now()
        html = "<html><body>It is now %s.</body></html>" % now
        return HttpResponse(html)
    

      尽管上面这种方法便于解释视图是如何工作的,但直接将HTML硬编码到视图里却并不是一个好主意。

        对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。 站点设计的修改往往比底层 Python 代码的修改要频繁得多,因此如果可以在不进行 Python 代码修改的情况下变更设计,那将会方便得多。
    
        Python 代码编写和 HTML 设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
    
        程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。
    上面这种HTML硬编码在python中的劣势

      基于上面这些原因,将页面的设计和Python的代码分离开会更干净简洁更容易维护。 我们可以使用 Django的 模板系统 (Template System)来实现这种模式。

      python的模板:HTML代码+模板语法

      模型包括在使用时会被值替换掉的 变量,和控制模版逻辑的 标签

      三种写法:

    def current_time(req):
        # ================================原始的视图函数
        # import datetime
        # now=datetime.datetime.now()
        # html="<html><body>现在时刻:<h1>%s.</h1></body></html>" %now
    
    
        # ================================django模板修改的视图函数
        # from django.template import Template,Context
        # now=datetime.datetime.now()
        # t=Template('<html><body>现在时刻是:<h1>{{current_date}}</h1></body></html>')
        # #t=get_template('current_datetime.html')
        # c=Context({'current_date':str(now)})
        # html=t.render(c)
        #
        # return HttpResponse(html)
    
    
        #另一种写法(推荐)
        import datetime
        now=datetime.datetime.now()
        return render(req, 'current_datetime.html', {'current_date':str(now)[:19]})
    

    一、模板语法之变量

      在 Django 模板中遍历复杂数据结构的关键是句点字符

      语法:

    {{var_name}}
    

    1、定义变量传入模板

    /templates_demo/app01/views.py:

    from django.shortcuts import render
    # Create your views here.
    
    def index(request):
        """
        模板语法只有两个:
        变量:{{}}
            1、深度查询   句点符
            2、过滤器
        标签:{% %}
        :param request:
        :return:
        """
        name = "yuan"  # 定义变量
        i = 10
        l = [111,222,333]
        info = {"name":"yuan","age":22}
    
        b = True
    
        class Person(object):
            def __init__(self, name, age):
                self.name = name
                self.age = age
    
        alex = Person("alex", 333)
        egon = Person("egon", 222)
    
        person_list = [alex, egon]
    
        # return render(request,"index.html", {'name': name})  # 注意模板文件和html文件的区别:含不含模板语法
        return render(request, "index.html",locals())   # 局部变量直接传入模板,变量名一一对应
    

    2、深度查询

      {{}}嵌套视图传进去的变量,如果是序列数据类型或对象可以通过“.”把响应的值取出来。

    /templates_demo/templates/index.html:

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
        <h1>index</h1>
        <p>{{ name }}</p>
        <p>{{ i }}</p>
        <p>{{ info }}</p>
        <p>{{ l }}</p>
        <p>{{ alex }}</p>
        <p>{{ person_list }}</p>
        <p>{{ b }}</p>
    
        <hr>
        深度查询
    
        <p>{{ l.1 }}</p>
        <p>{{ info.name }}</p>
        <p>{{ alex.age }}</p> <!--拿到对象的属性-->
        <p>{{ person_list.1.age }}</p>   <!--拿到列表中第二个对象的age属性-->
    </body>
    </html> 

    运行结果:

      

      注意:句点符也可以用来引用对象的方法(无参数方法):

    <h4>字典:{{ dic.name.upper }}</h4>

    3、模板语法之过滤器

      功能:把视图传进来的变量加以修饰后再显示

      语法:

    {{obj|filter__name:param}}

    (1)default

      如果一个变量是false或者为空,使用给定的默认值。否则,使用变量的值。例如:

    {{ value|default:"nothing" }}

    (2)length

      返回值的长度。它对字符串和列表都起作用。例如:

    {{ value|default:"nothing" }}

      如果value是['a','b','c','d'],那么输出是4。

    (3)filesizeformat

      将值格式化为一个 “人类可读的” 文件尺寸 (例如 '13 KB''4.1 MB''102 bytes', 等等)。例如:

    {{ value|filesizeformat }}

      如果 value 是 1234345,输出将会是 1.2 MB。  

    (4)date

      如果 value=datetime.datetime.now()

    {{ value|date:"Y-m-d" }}  

    (5)slice

      如果 value="hello world",如下会输出:llo worl

    {{ value|slice:"2:-1" }}

    (6)truncatechars

      如果字符串字符多于指定的字符数量,那么会被截断截断的字符串将以可翻译的省略号序列(“...”)结尾。

      参数:要截断的字符数

      例如:

    {{ value|truncatechars:9 }}

      如果value是"Joel  是  a  >",输出将会是:"Joel  i  ..."。

    (7)safe

      Django的模板中会对HTML标签和JS等语法标签进行自动转义,原因显而易见,这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义,比如我们做一个内容管理系统,后台添加的文章中是经过修饰的,这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本,如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式,如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。

    link = '<a href=">click</a>'

      直接在模板中使用link:

    <p>{{ link }}</p>

    在页面中,Django默认做了转义,&lt;a href=&quot;&gt;click&lt;/a&gt;

      因此必须添加safe过滤器:

    <p>{{ link|safe }}</p>

    代码示例:

    from django.shortcuts import render
    
    # Create your views here.
    
    
    def index(request):
        """
        模板语法只有两个:
        变量:{{}}
            1、深度查询   句点符
            2、过滤器
        标签:{% %}
        :param request:
        :return:
        """
        name = "yuan"  # 定义变量
        i = 10
        l = [111,222,333]
        info = {"name":"yuan","age":22}
    
        b = True
    
        class Person(object):
    
            def __init__(self, name, age):
                self.name = name
                self.age = age
    
        alex = Person("alex", 333)
        egon = Person("egon", 222)
    
        person_list = [alex, egon]
    
        people_list = []
    
        #######################
        import datetime
    
        now = datetime.datetime.now()
    
        file_size= 1234345
    
        value = "hello world"
        text = "hello python hi luffycity go java linux"
    
        link = '<a href=">click</a>'
    
    
        # return render(request,"index.html", {'name': name})  # 注意模板文件和html文件的区别:含不含模板语法
    
        return render(request, "index.html",locals())   # 局部变量直接传入模板,变量名一一对应
    /templates_demo/app01/views.py

     /templates_demo/templates/index.html:

    <h3>过滤器</h3>
    <p>{{ now }}</p>
    <p>{{ now|date:"Y-m-d" }}</p>
    <p>{{ people_list|default:"数据为空" }}</p>
    <p>{{ person_list|length }}</p>
    <p>{{ file_size|filesizeformat }}</p>
    <p>{{ value|slice:"2:-1" }}</p>
    <p>{{ text|truncatechars:9 }}</p>
    <p>{{ link }}</p>
    <p>{{ link|safe }}</p>
    

      在页面中展示效果:

        

    这里简单介绍一些常用的模板的过滤器,更多详见

    二、模板语法之标签

      标签看起来像是这样的: {% tag %}。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模版中。

      一些标签需要开始和结束标签 (例如{% tag %} ...标签 内容 ... {% endtag %})。

    1、for标签

    (1)遍历每一个元素:

    {% for i in l %}
        <p>{{  i }}</p>
    {% endfor %}
    

      利用{% for obj in list reversed %}反向完成循环

    {% for i in l reversed %}
        <p>{{  i }}</p>
    {% endfor %}
    

    (2)遍历一个字典:views.py中有:info = {"name":"yuan","age":22}

    {% for i in info %}
        <p>{{ i }}</p>
    {% endfor %}
    

      页面显示:name:yuan     age:22

    (3)遍历对象数组

    {% for person in person_list %}
        <p>{{ person.name }}  {{ person.age }}</p>
    {% endfor %}
    
    {# forloop.counter 序号,默认从1开始计数  counter0的序号,从0开始计数 #}
    {% for person in person_list %}
        <p>{{ forloop.counter0 }} {{ person.name }}  {{ person.age }}</p>
    {% endfor %}
    

      页面显示:alex 333       egon 222

             0 alex 333       1 egon 222

    注:循环序号可以通过{{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

    2、for...empty

      for 标签带有一个可选的{% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。

      如:在view.py中创建:empty_list = []

    {% for n in empty_list%}
        <p>{{ forloop.counter0 }} {{ n.name }}  {{ n.age }}</p>
        {% empty %}
        <p>列表为空</p>
    {% endfor %}
    

      页面显示:列表为空。

    3、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 %}
    

      示例:

    {% if user %}
        <p>
            <a href="">hi {{ user }}</a>
            <a href="">注销</a>
        </p>
    {% else %}
        <p>
            <a href="">登录</a>
            <a href="">注册</a>
        </p>
    {% endif %}
    

      当user = None,页面显示:登录 注册

      当user = alex,页面显示:hi alex 注销

    4、with标签

      使用一个简单的名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的。(替换名字)

    {{ person_list.1.name }}
    {% with person_list.1.name as p_l %}
        {{ p_l }}
    {% endwith %}
    

      例如上例这种,由于深度查询非常长,用一个简单的名字替换。   

    5、csrf_token

      这个标签用于跨站请求伪造保护。{% csrf_token %}可以渲染出一个input标签。点击提交时,会提交给服务器验证通过校验。如下图所示:

      

    (1)代码示例:

      urls.py:

    from django.contrib import admin
    from django.urls import path, re_path
    
    from app01 import views
    
    urlpatterns = [
        path('admin/', admin.site.urls),
        path('index/', views.index),    # 含正则的时候需要使用re_path
        path('login/', views.login)
    ]
    

      app01/views.py:

    from django.shortcuts import render,HttpResponse
    # Create your views here.
    
    def login(request):
        if request.method == "POST":
            return HttpResponse("OK")
        return render(request, "login.html")
    

      login.html:

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
    <form action="" method="post">
        {% csrf_token %}
        <input type="text" name="user">
        <input type="submit">
    </form>
    </body>
    </html>
    

    (2)在浏览器运行效果如下

      1)没有添加csrf_token时,输入信息点击提交

      

      2)添加了csrf_token后:

      

    三、自定义标签和过滤器

    1、在settings中的INSTALLED_APPS配置当前app

      不然django无法找到自定义的simple_tag

      

    2、在app中创建templatetags模块

      注意:模块名只能是templatetags

      

      Django去找自定义标签的时候,就固定会在注册的app中寻找templatetags的package.

    3、在templatetags中创建任意 .py 文件

      如创建:my_tags_filter.py

    from django import template
    
    register = template.Library()   # register不能变
    
    @register.filter
    def multi_filter(x,y):
        # 新过滤器,实现相乘
        return x*y
    
    @register.simple_tag
    def multi_tag(x,y):
        # 新标签
        return x**y
    
    @register.simple_tag
    def multi_tag_higher(x, y, z):
        return x*y*z
    
    from django.utils.safestring import mark_safe
    
    @register.simple_tag
    def my_input(id,arg):
        result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
        return mark_safe(result)
    

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

    {% load my_tags_filter %}
    

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

    <h4>自定义过滤器</h4>
    {% load my_tags_filter %}
    <p>{{ i|multi_filter:20 }}</p>
    
    <h4>自定义标签</h4>
    <p>{% multi_tag 4 2 %}</p>
    <p>{% multi_tag_higher 3 2 4 %}</p>
    
    {#  过滤器最多只能传两个形参;自定义标签没有数量限制  #}
    {#  标签不能进行逻辑判断  #}
    {% if i|multi_filter:10 > 50 %}
        <p>1010</p>
    {% else %}
        <p>{{ i }}</p>
    {% endif %}

       注意:过滤器({{  }})可以用再if等语句后,标签({%  %})不可以进行逻辑判断

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

    6、simple_tag 和 filter 的区别

    • simple_tag:可以有多个参数,一般是做数据处理,但不能做if判断语句
    • filter:一般只能有1个参数(可以字符串切割,变通为多个参数),过滤器,一般是return true或者false,可以和if判断语句使用.在过滤器 {{ var|foo:"bar" }} 中 ,过滤器 foo 会被传入变量 var 和默认参数 bar。过滤器函数应该总有返回值

    四、模板继承(extend)标签

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

      还是用templates_demo这个项目为例来理解模板继承:

    1、include 模板标签  {% include %}

      利用模板加载机制的内建模板标签: {% include %} 。该标签允许在(模板中)包含其它的模板的内容。 标签的参数是所要包含的模板名称,可以是一个变量,也可以是用单/双引号硬编码的字符串。 每当在多个模板中出现相同的代码时,就应该考虑是否要使用 {% include %} 来减少重复。

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
        <style type="text/css">
            * {
                margin: 0;
                padding: 0;
            }
            .header{
                width: 100%;
                height: 50px;
                background-color: #369;
            }
        </style>
    </head>
    <body>
        <div class="header"></div>
    
        <div class="container">
            <div class="row">
                <div class="col-md-3">
                    {% include 'advertise.html' %}
                </div>
                <div class="col-md-9">
                    <h1>index</h1>
                    <p>{{ name }}</p>
                    <p>{{ i }}</p>
                    <p>{{ info }}</p>
                    <p>{{ l }}</p>
                    <p>{{ alex }}</p>
                    <p>{{ person_list }}</p>
                    <p>{{ b }}</p>
    
                    <hr>深度查询
                    <p>{{ l.1 }}</p>
                    <p>{{ info.name }}</p>
                    <p>{{ alex.age }}</p> <!--拿到对象的属性-->
                    <p>{{ person_list.1.age }}</p>   <!--拿到列表中第二个对象的age属性-->
    
                    <h3>过滤器</h3>
                    <p>{{ now }}</p>
                    <p>{{ now|date:"Y-m-d" }}</p>
                    <p>{{ people_list|default:"数据为空" }}</p>
                    <p>{{ person_list|length }}</p>
                    <p>{{ file_size|filesizeformat }}</p>
                    <p>{{ value|slice:"2:-1" }}</p>
                    <p>{{ text|truncatechars:9 }}</p>
                    <p>{{ link }}</p>
                    <p>{{ link|safe }}</p>
    
                    <h4>for标签</h4>
                    {% for i in l reversed %}
                        <p>{{  i }}</p>
                    {% endfor %}
                    {% for i, j in info.items %}
                        <p>{{ i }}:{{ j }}</p>
                    {% endfor %}
                    {% for person in person_list %}
                        <p>{{ person.name }}  {{ person.age }}</p>
                    {% endfor %}
    
                    {# forloop.counter 序号,默认从1开始计数  counter0的序号,从0开始计数 #}
                    {% for person in person_list %}
                        <p>{{ forloop.counter0 }} {{ person.name }}  {{ person.age }}</p>
                    {% endfor %}
    
                    {% for n in empty_list%}
                        <p>{{ forloop.counter0 }} {{ n.name }}  {{ n.age }}</p>
                        {% empty %}
                        <p>列表为空</p>
                    {% endfor %}
    
                    <hr>
                    {% if user %}
                        <p>
                            <a href="">hi {{ user }}</a>
                            <a href="">注销</a>
                        </p>
                    {% else %}
                        <p>
                            <a href="">登录</a>
                            <a href="">注册</a>
                        </p>
                    {% endif %}
    
                    <hr>
                    {{ person_list.1.name }}
                    {% with person_list.1.name as p_l %}
                        {{ p_l }}
                    {% endwith %}
                    <hr>
    
                    <h4>自定义过滤器</h4>
                    {% load my_tags_filter %}
                    <p>{{ i|multi_filter:20 }}</p>
    
                    <h4>自定义标签</h4>
                    <p>{% multi_tag 4 2 %}</p>
                    <p>{% multi_tag_higher 3 2 4 %}</p>
    
                    {#  过滤器最多只能传两个形参;自定义标签没有数量限制  #}
                    {#  标签不能进行逻辑判断  #}
                    {% if i|multi_filter:10 > 50 %}
                        <p>1010</p>
                    {% else %}
                        <p>{{ i }}</p>
                    {% endif %}
                </div>
            </div>
        </div>
    </body>
    </html>
    /templates_demo/templates/index.html

      利用模板里的{% include 'advertise.html' %} 引入advertise.html

    <div class="action">
        <div class="panel panel-danger">
            <div class="panel-heading">Panel heading without title</div>
            <div class="panel-body">
                Panel content  111
            </div>
        </div>
        <div class="panel panel-warning">
            <div class="panel-heading">Panel heading without title</div>
            <div class="panel-body">
                Panel content  222
            </div>
        </div>
        <div class="panel panel-success">
            <div class="panel-heading">Panel heading without title</div>
            <div class="panel-body">
                Panel content  333
            </div>
        </div>
    </div>
    /templates_demo/templates/advertise.html

      运行后浏览器效果如下所示:

      

    2、模板继承{% extends 'base.html' %}

    (1)/templates/base.html:

      一般都是用base.html定义了一个可以用于两列排版页面的简单HTML骨架

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
        <style type="text/css">
            * {
                margin: 0;
                padding: 0;
            }
            .header{
                 100%;
                height: 50px;
                background-color: #369;
            }
        </style>
    </head>
    <body>
        <div class="header"></div>
    
        <div class="container">
            <div class="row">
                <div class="col-md-3">
                    {% include 'advertise.html' %}
                </div>
                <div class="col-md-9">
                    {% block con %}
    
                    {% endblock %}
                </div>
            </div>
        </div>
    </body>
    </html>

    (2)子模板/templates/index.html

      “子模版”的工作是用它们的内容填充空的blocksblock 告诉模版引擎: 子模版可能会覆盖掉模版中的这些位置。

    {% extends 'base.html' %}
    
    
    {% block con %}
        <h1>index</h1>
        <p>{{ name }}</p>
        <p>{{ i }}</p>
        <p>{{ info }}</p>
        <p>{{ l }}</p>
        <p>{{ alex }}</p>
        <p>{{ person_list }}</p>
        <p>{{ b }}</p>
    
        <hr>深度查询
        <p>{{ l.1 }}</p>
        <p>{{ info.name }}</p>
        <p>{{ alex.age }}</p> <!--拿到对象的属性-->
        <p>{{ person_list.1.age }}</p>   <!--拿到列表中第二个对象的age属性-->
    
        <h3>过滤器</h3>
        <p>{{ now }}</p>
        <p>{{ now|date:"Y-m-d" }}</p>
        <p>{{ people_list|default:"数据为空" }}</p>
        <p>{{ person_list|length }}</p>
        <p>{{ file_size|filesizeformat }}</p>
        <p>{{ value|slice:"2:-1" }}</p>
        <p>{{ text|truncatechars:9 }}</p>
        <p>{{ link }}</p>
        <p>{{ link|safe }}</p>
    
        <h4>for标签</h4>
        {% for i in l reversed %}
            <p>{{  i }}</p>
        {% endfor %}
        {% for i, j in info.items %}
            <p>{{ i }}:{{ j }}</p>
        {% endfor %}
        {% for person in person_list %}
            <p>{{ person.name }}  {{ person.age }}</p>
        {% endfor %}
    
        {# forloop.counter 序号,默认从1开始计数  counter0的序号,从0开始计数 #}
        {% for person in person_list %}
            <p>{{ forloop.counter0 }} {{ person.name }}  {{ person.age }}</p>
        {% endfor %}
    
        {% for n in empty_list%}
            <p>{{ forloop.counter0 }} {{ n.name }}  {{ n.age }}</p>
            {% empty %}
            <p>列表为空</p>
        {% endfor %}
    
        <hr>
        {% if user %}
            <p>
                <a href="">hi {{ user }}</a>
                <a href="">注销</a>
            </p>
        {% else %}
            <p>
                <a href="">登录</a>
                <a href="">注册</a>
            </p>
        {% endif %}
    
        <hr>
        {{ person_list.1.name }}
        {% with person_list.1.name as p_l %}
            {{ p_l }}
        {% endwith %}
        <hr>
    
        <h4>自定义过滤器</h4>
        {% load my_tags_filter %}
        <p>{{ i|multi_filter:20 }}</p>
    
        <h4>自定义标签</h4>
        <p>{% multi_tag 4 2 %}</p>
        <p>{% multi_tag_higher 3 2 4 %}</p>
    
        {#  过滤器最多只能传两个形参;自定义标签没有数量限制  #}
        {#  标签不能进行逻辑判断  #}
        {% if i|multi_filter:10 > 50 %}
            <p>1010</p>
        {% else %}
            <p>{{ i }}</p>
        {% endif %}
    {% endblock %}
    /templates/index.html

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

      模版引擎将注意到 base.html 中的 block 标签,并用子模版中的内容来替换这些block。再次访问页面:

      

      同时如果想定制一个和父模板基本相同的页面如order.html:

    {% extends 'base.html' %}
    
    
    {% block con %}
        <h3>订单</h3>
    {% endblock %}
    

      显示效果如下:

      

    (3)在base.html中定义多个block

      在base.html中可以定义多个block方便继承的页面扩写内容,解决http页面代码复用性的问题。比如把titile标签改为block:

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        {% block title %}
    
        {% endblock %}
        <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
        <style type="text/css">
            * {
                margin: 0;
                padding: 0;
            }
            .header{
                width: 100%;
                height: 50px;
                background-color: #369;
            }
        </style>
    </head>
    <body>
        <div class="header"></div>
    
        <div class="container">
            <div class="row">
                <div class="col-md-3">
                    {% include 'advertise.html' %}
                </div>
                <div class="col-md-9">
                    {% block con %}
    
                    {% endblock %}
                </div>
            </div>
        </div>
    </body>
    </html>
    base.html
    {% extends 'base.html' %}
    
    {% block title %}
        <titile>orders</titile>
    {% endblock %}
    
    
    {% block con %}
        <h3>订单</h3>
    {% endblock %}
    

      请注意,子模版并没有定义 sidebar block,所以系统使用了父模版中的值。父模版的 {% block %} 标签中的内容总是被用作备选内容(fallback)。

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

    (4)这里是使用继承的一些提示

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

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

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

      4)如果需要从父模板中获取block中的内容,可以使用{{ block.super }}拿到父模板的内容,并继续续写。

    {% extends 'base.html' %}
    
    {% block title %}
        <titile>orders</titile>
    {% endblock %}
    
    {% block con %}
        {{ block.super }}
        <h3>订单</h3>
    {% endblock %}
    

      base.html:

    <div class="col-md-9">
        {% block con %}
            <h4>content</h4>
        {% endblock %}
    </div>    
    

      访问网页效果如下:

      

      5)为了更好的可读性,你也可以给你的 {% endblock %} 标签一个 名字 。例如:

    {% block content %}
    ...
    {% endblock content %}  
    

      在大型模版中,这个方法帮你清楚的看到哪一个  {% block %} 标签被关闭了。

      6)不能在一个模版中定义多个相同名字的 block 标签。

    3、总结extend和include

      include有功能extend都有,但extend扩展盒子的功能include不具备。因此extend功能更加强大,推荐在模板复用的时候使用继承关系。

  • 相关阅读:
    ECshop 二次开发模板教程4
    ECshop 二次开发模板教程3
    ECshop 二次开发模板教程2
    ECshop 二次开发模板教程1
    ecshop 二次开发及模板标签
    ECSHOP seo修改建议
    Ecshop ajax 局部刷新购物车功能
    ECSHOP
    echo二次开发 ecshop 函数列表
    Ecshop文件结构,二次开发
  • 原文地址:https://www.cnblogs.com/xiugeng/p/9259242.html
Copyright © 2020-2023  润新知