Django的模板系统-白红宇

Django的模板系统

阅读量：6114 次

发布时间：2019-06-21

本文共 7292 字，大约阅读时间需要 24 分钟。

模板系统介绍

模板系统的组成：HTML代码和逻辑控制代码

逻辑控制代码可以理解是django模板语言

django的模板语言组成

变量（使用双大括号来引用变量）：

标签（tag）的使用（使用大括号和百分比的组合来表示使用tag）

模板继承

模板语言之变量

语法：

{
    {var_name}}   var_name 指变量名

使用模板语言之前：

先介绍template对象和Context对象

进入django的项目的交互环境

python manange.py shell>>> from django.template import Context, Template>>> t = Template('My name is {
    { name }}.')   #模板对象>>> c = Context({'name': 'xixi'})       #上下文对象>>> t.render(c)'My name is xixi.'

同一模板，多个上下文，一旦有了模板对象，你就可以通过它渲染多个context，无论何时我们都可以像这样使用同一模板源渲染多个context，只进行一次模板创建然后多次调用render()方法渲染会更为高效：

模板对象：可以理解文HTML文件，只不过包含了Django的模板语法

context对象：大多数的情况下，我们会将字典传给Context()，一旦初始化后，就可以使用标准的Python字典语法操作Context对象：

上下文对象如果是不合法的变量，模板系统会把他当做空字符串显示

>>> t = Template('Your name is {
    {  name }}')   变量名是name>>> t.render(Context({'var':'hello'}))  #没有var这个变量名字'Your name is '

变量之深度查询（英文句点符.）

上面只是通过 context 传递的简单参数值主要是字符串，然而，模板系统能够非常简洁地处理更加复杂的数据结构，例如list、dictionary和自定义的对象。

list索引

>>> from django.template import Context, Template>>> names = ["xixi","abc","123","hehe"]>>> t = Template("this is {
    { name.0}}")>>> c = Context({"name":names})>>> t.render(c)'this is xixi'

如果不写 {

{ name.0}} 后面的（.索引）表示整个列表

字典

>>> from  django.template  import  Template, Context>>> person = {'name':"xixi", "age": 21}>>> t = Template("{
    { person.name }} is {
    { person.age }} years old.")>>> c = Context({ "person": person })>>> t.render(c)'xixi is 25 years old.'

自定义对象

>>> from   django.template  import  Template, Context>>> import  datetime>>> d = datetime.date(1996, 12,12 )>>> d.year1996>>> d.month12>>> d.day12>>> t = Template('The month is {
    { date.month }} and year is {
    { date.year }}')>>> c = Context({'date': d})>>> t.render(c)'The month is 12 and year is 1996'

访问对象方法

>>> t = Template('{
    { var }} -- {
    { var.upper }} -- {
    {  var.isdigit }}')>>> t.render(Context({'var': 'hello'}))'hello -- HELLO -- False'>>> t.render(Context({'var': '123'}))'123 -- 123 -- True'

跟python操作差不多

变量过滤器（filter）的使用

语法格式

{
    {var|filter:param}}

管道符号后面的功能，比如{

{ var|length }}，求变量长度的 length 就是一个过滤器。

常用的过滤器

1.add          ：   给变量加上相应的值  2 addslashes   :    给变量中的引号前加上斜线 3  capfirst     :    首字母大写 4  cut          ：   从字符串中移除指定的字符 5  date         ：   格式化日期字符串6  default      ：   如果值是False,就替换成设置的默认值，否则就是用本来的值7  default_if_none:  如果值是None，就替换成设置的默认值，否则就使用本来的值

标签(tag)的使用

语法格式

{% tags %}

{% if %} 的使用

{% if %} 和 {% endif %}要成对

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

{% if num >= 100 and 8 %}    {% if num > 200 %}        num大于200
    {% else %}        num大于100小于200
    {% endif %}{% elif num < 100%}    num小于100
{% else %}    num等于100
{% endif %}{% if %} 标签接受and，or或者not来测试多个变量值或者否定一个给定的变量{% if %} 标签不允许同一标签里同时出现and和or，否则逻辑容易产生歧义，例如下面的标签是不合法的：{% if obj1 and obj2 or obj3 %}

{% for %}的使用

{% for %} 和 {% endfor %}要成对

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

基本格式
     
      {% for obj in list %}    
      {
    { obj.name }}
{% endfor %}

在标签里添加reversed来反序循环列表：

{% for obj in list reversed %}    ...{% endfor %}

{% for %}标签可以嵌套：

{% for country in countries %}        {
    { country.name }}
        
     
               {% for city in country.city_list %}            
      {
    { city }}
         {% endfor %}        
     
{% endfor %}

{% for %}不支持中断循环，也不支持continue语句

{% for %}关于循环其他用法

forloop.counter表示循环的次数，它从1开始计数，第一次循环设为1:forloop.counter0	索引从 0 开始算forloop.revcounter表示循环中剩下的items数量，第一次循环时设为items总数，最后一次设为1forloop.revcounter0表示`items总数少一个，最后一次循环设置为0forloop.first表示当第一次循环时值为True，在特别情况下很有用：forloop.last表示当最后一次循环时值为Trueforloop。parentioop表示在嵌套循环中表示父级循环的forloop

富有魔力的forloop变量只能在循环中得到，当模板解析器到达{% endfor %}时forloop就消失了

如果你的模板context已经包含一个叫forloop的变量，Django会用{% for %}标签替代它

Django会在for标签的块中覆盖你定义的forloop变量的值

在其他非循环的地方，你的forloop变量仍然可用

{% for item in todo_list %}        {
    { forloop.counter }}: {
    { item }}
{% endfor %}表示循环的次数，它从1开始计数，第一次循环设为1:

{%csrf_token%}：csrf_token标签

用于生成csrf_token的标签，用于防治跨站攻击验证。注意如果你在view的index里用的是render_to_response方法，不会生效

{% url %}: 引用路由配置的地址


               
                
                {%csrf_token%}

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

{% with total=fhjsaldfhjsdfhlasdfhljsdal %} {
    { total }} {% endwith %}基本很少起复杂变量名，一般起变量名都要特变形象

{% verbatim %}: 禁止render渲染

{% verbatim %}         {
    { hello }}{% endverbatim %如果想要{
    {hello}}在网页正常显示出来，则用这个

{% load %}: 加载标签库

静态文件的引入方式用过

{% load staticfiles %}

后面引入其他的标签库在一一列出

自定义filter和simple_tag

我们自定义过滤器和简单的标签我们需要

在app中创建templatetags文件夹(文件夹名字必须的是这个)

创建任意 .py 文件，如：my_tags.py

#!/usr/bin/env python#-*- coding:utf-8 -*-from django import templatefrom django.utils.safestring import mark_saferegister = template.Library()  #register的名字是固定的,不可改变@register.filterdef filter_multi(x,y):    return x*y@register.simple_tagdef simple_tag_multi(x,y):    return x*y@register.simple_tagdef my_input(id,arg):    result = "" %(id,arg)    return mark_safe(result)

如何调用自定义filter和simple_tag

在使用自定义simple_tag和filter的html文件中导入之前创建的 my_tags.py ：{% load my_tags %}

在settings中的INSTALLED_APPS配置当前app，不然django无法找到自定义的simple_tag.

{% load my_tags %}    
         Title{
    { num|filter_multi:2 }} #24 
{
    { num|filter_multi:"[22,333,4444]" }}
{% simple_tag_multi 2 5 %}  参数不限,但不能放在if for语句中 
{% simple_tag_multi num 5 %}

视图和路由的配置文件

#路由from django.conf.urls import urlfrom django.contrib import adminfrom app01 import viewsurlpatterns = [    url(r'^admin/', admin.site.urls),    url(r'^index/',views.index),]#视图from django.shortcuts import render,HttpResponse# Create your views here.def index(request):    num=12    return  render(request,"index.html",locals())

注：filter可以用在if等语句后，simple_tag不可以

模板引入和继承

模板引入

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

引入方法

{% load staticfiles %}HTML相关内容{% include '要引入的html文件名' %}

模板继承

常见的 Web 开发问题：在整个网站中，如何减少共用页面区域（比如站点导航）所引起的重复和冗余代码？

解决该问题的传统做法是使用 服务器端的 includes ，你可以在 HTML 页面中使用该指令将一个网页嵌入到另一个中。事实上， Django 通过刚才讲述的 {% include %} 支持了这种方法。但是用 Django 解决此类问题的首选方法是使用更加优雅的策略—— 模板继承 。

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

如果子板不自定义块，默认会继承母板的所有内容（包括模板的css，js），如果子板要修改css或js文件，在相应地方加块，就可以了

例如：

简单写一个子板继承母板

定义母板文件base.html，定义子板要自定义的块

    
         Title HAHA 
{% block  content %}    子板自定义修改的内容
{% endblock %}

定义子板文件child.html

{% extends "base.html" %}

子板如果就这么一行代码，就会继承母板的所有内容，这{% extends "母板文件" %}必须写在最首行

如果要自定义修改块

{% extends "base.html" %}{% block content %}    我是子板，修改了母板自定义块的内容
{% endblock %}

注：

母板

{% block 自定义块名%}

子板的块

{% block 母板中相应设置的块名 }

{% block %} 内容 {% endblock %}的标签也是成对出现

使用继承的注意事项：

创建 base.html 模板，在其中定义站点的主要外观感受。这些都是不常修改甚至从不修改的部分。

为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。这些模板对base.html 进行拓展，并包含区域特定的风格与设计。

为每种类型的页面创建独立的模板，例如论坛页面或者图片库。这些模板拓展相应的区域模板。

模板继承的一些诀窍：

如果在模板中使用 {% extends %} ，必须保证其为模板中的第一个模板标记。否则，模板继承将不起作用。

一般来说，基础模板中的 {% block %} 标签越多越好。记住，子模板不必定义父模板中所有的代码块，因此你可以用合理的缺省值对一些代码块进行填充，然后只对子模板所需的代码块进行（重）定义。俗话说，钩子越多越好。

如果发觉自己在多个模板之间拷贝代码，你应该考虑将该代码段放置到父模板的某个 {% block %} 中。如果你需要访问父模板中的块的内容，使用 {
{ block.super }}这个标签吧，这一个魔法变量将会表现出父模板中的内容。如果只想在上级代码块基础上添加内容，而不是全部重载，该变量就显得非常有用了。

不允许在同一个模板中定义多个同名的 {% block %} 。存在这样的限制是因为block 标签的工作方式是双向的。也就是说，block 标签不仅挖了一个要填的坑，也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 {% block %} 标签，父模板将无从得知要使用哪个块的内容。