首页 > 代码库 > Django学习系列之模板系统

Django学习系列之模板系统

一、模板标签

if/else

{%  if  %}标签检查一个变量的值是否为真或者等于另外一个值,如果为真,系统会执行{%  if  %}和{%  endif  %}之间的代码块,例如:

{% if today_is_weekend %}
    <p>Welcome to the weekend!</p>
{% endif %}

{%  else  %}标签是可选的,如果不为真则执行{%  else  %}和{%  endif  %}之间的代码块

注意:一定要用{%  endif  %}关闭每一个{%  if  %}代码块

for

{%  for  %}允许我们在一个序列上迭代,与Python的 for 语句的情形类似,循环语法是for X in YY是要迭代的序列而X是在每一个特定的循环中使用的变量名称。每一次循环中,模板系统会渲染在{ % for % } 和{ % endfor % }之间的所有内容,例如:

{% for athlete in athlete_list   %}
    <li>{{ athlete.name }}</li>
{% endfor %}

forloop

技术分享

二、模板继承

概念:

模板继承是先构建一个基础模板框架,然后其他子模板继承这个基础模板

示例

定义urls.py

from django.conf.urls import url
from django.contrib import admin
from cmdb import views
urlpatterns = [
    url(r^assets/, views.assets),
    url(r^user/, views.user),
]

定义views.py

def assets(request):
    assets_list = []
    for i in range(10):
        temp = {host:host + str(i)}
        assets_list.append(temp)
    return render(request,assets.html,{assets_list:assets_list})

def user(request):
    user_list = []
    for i in range(5):
        temp = {user:alex+str(i)}
        user_list.append(temp)
    return render(request,user.html,{user_list:user_list})

定义基础模板(layout.py)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
     <style>
        .pg-header{
            height: 48px;
            background-color: cadetblue;
        }
        .pg-body{
            min-height: 500px;
        }
        .pg-body .body-menu{
            width: 20%;
            float: left;
        }
        .pg-body .body-content{
            width: 80%;
            float: left;
        }
        .pg-footer{
            height: 100px;
            background-color: brown;
        }
        .active{
            background-color: aquamarine;
            color: white;
        }
    </style>
</head>
<body>
    <div class="pg-header">
        后台系统V1
    </div>
    <div class="pg-body">
        <div class="body-menu">
            <ul>
                <li><a id="assets" href=http://www.mamicode.com/"/assets">资产管理</a></li>
                <li><a id="assets" href=http://www.mamicode.com/"/user"  >用户管理</a></li>
            </ul>
        </div>
        <div class="body-content">
             {% block body %}{% endblock %}      #这里表示子模板继承该模板之后,这里的值是可以被子模板中的值覆盖的
</div> </div> <div class="pg-footer"></div> </body> </html>

定义子模板(user.html)

{% extends layout.html %}              #引用layout.html模板

{% block body %}                         #这里表示覆盖掉基础模板中block body的部分
    <ul>
    {% for item in user_list %}
        <li>{{ item.user }}</li>
    {% endfor %}
    </ul>
{% endblock %}

定义子模板(assets.py)

{% extends layout.html %}                #引用layout.html模板

{% block body %}                           #这里表示覆盖掉基础模板中block body的部分 
    <ul>
    {% for item in assets_list %}
        <li>{{ item.host }}</li>
    {% endfor %}
    </ul>
{% endblock %}

效果展示

技术分享

测试:在母板(基础模板)中把"后台系统V1"修改为"后台系统V2",然后两个子模板中随之改变

技术分享

模板继承工作方式

在加载user.html和assets.html模板时,模板引擎发现{%  extends %}标签,注意到该模板是一个子模板,模板引擎立即加载其母模板,即本例中的layout.html

此时,模板引擎注意到一个{%  block  %}标签,并用子模板的内容替换掉block,模板引擎将会使用我们在{%  block body  %}中定义的内容

模板继承常见三层法

  1. 创建基础模板(母模板),主要在其中定义站点的外观,这些都是不常修改或者说是从不修改的内容
  2. 为网站的每个区域创建子模板,这些子模板对其基础模板(母模板)进行拓展,
  3. 为每种类型的页面创建独立的模板,例如论坛页面或者图片库,这些模板拓展相应的区域模板

这个方法可最大限度地重用代码,并使得向公共区域(如区域级的导航)添加内容成为一件轻松的工作

以下是模板继承的一些诀窍:

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

  • { % extends % }对所传入模板名称使用的加载方法和get_template()相同。 也就是说,会将模板名称被添加到TEMPLATE_DIRS设置之后;

  • 多数情况下,{ % extends % }的参数应该是字符串,但是如果直到运行时方能确定父模板名,这个参数也可以是个变量,这使得你能够实现一些很酷的动态功能;

 

Django学习系列之模板系统