有事没事领个红包

django中templates阅读笔记

一、基本知识

1、模版是独立于django的,可以独立运行。

  • 模版变量是用两个大括号括起来的字符串，表示变量。例如{{ person_name }}
  • 模版标签，是用一对大括号和一对百分号括起来的，例如{% if ordered_warranty %}，{% for item in item_list %}
  • 过滤器，修改变量格式。{{ ship_date|date:"F j, Y" }}

2、产生TemplateSyntaxError异常的原因有

  • Invalid tags
  • Invalid arguments to valid tags
  • Invalid filters
  • Invalid arguments to valid filters
  • Invalid template syntax
  • Unclosed tags (for tags that require closing tags)

3、在django模版中可以处理复杂的数据类型，例如属性、方法。通过点运算符表示

>>> from django.template import Template, Context
>>> person = {'name': 'Sally', 'age': '43'}
>>> t = Template('{{ person.name }} is {{ person.age }} years old.')
>>> c = Context({'person': person})
>>> t.render(c)
u'Sally is 43 years old.'

person是一个字典，在模版中需要使用person的属性，可以通过点运算符表示。给模版传递的是字典，用的是属性。

4、用点来引用方法，例如字符串有upper()，isdigit()方法。

注意：调用的方法必须没有参数，如果有参数，则不可以调用。

>>> from django.template import Template, Context
>>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}')
>>> t.render(Context({'var': 'hello'}))
u'hello -- HELLO -- False'
>>> t.render(Context({'var': '123'}))
u'123 -- 123 -- True'

5、用点表示列表索引

注意：索引只能是自然数。

>>> from django.template import Template, Context
>>> t = Template('Item 2 is {{ items.2 }}.')
>>> c = Context({'items': ['apples', 'bananas', 'carrots']})
>>> t.render(c)
u'Item 2 is carrots.'
View Code

6、点用法小结，当模版中变量遇到点操作符时，解析器会按照如下顺序进行解析

  • Dictionary lookup (e.g., foo["bar"])
  • Attribute lookup (e.g., foo.bar)
  • Method call (e.g., foo.bar())
  • List-index lookup (e.g., foo[2])

也可以多层使用点运算符，例如：{{ person.name.upper }}

7、如果不想让对象使用某一个方法，修改函数的alters_data属性

def delete(self):
    # Delete the account
delete.alters_data = True

二、基本模版标签和过滤器

1、if/else

{% if  variable %},{% else %},{% endif %}和python中差不多，只是需要有{% endif %}来结束一个{% if %}标签

如果想要测试多个条件，可以使用and,or,not。尽量避免混合使用，以至于逻辑混乱。可以使用一个逻辑关系来多次判断，比如condition1 or condition2 or condition3

如果必须混合使用逻辑关系，可以使用嵌套的{% if %}{% else %}标签。

{% if athlete_list %}
    {% if coach_list or cheerleader_list %}
        We have athletes, and either coaches or cheerleaders!
    {% endif %}
{% endif %}
View Code

注意：模版语言中没有{% elif %}标签。需要嵌套使用逻辑关系来表示。

2、for标签，可以循环一个列表

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

其中，athlete是变量，athlete_list是列表。

也可以逆序循环一个列表，添加一个reversed到for标签中。

{% for athlete in athlete_list reversed %}
...
{% endfor %}

注意：没有跳出循环的break标签，也没有继续下一个循环的continue标签。

3、在for标签之内，有一个变量是forloop有一些属性，可以使用

  • forloop.counter，表示进入for循环的次数，第一次是1
  • forloop.counter0，跟上一个一样，只不过第一次是0，
  • forloop.revcounter，表示剩余循环次数，最后一次是1
  • forloop.revcounter0，跟上一个一样的功能，只不过最后一次是0
  • forloop.first，是一个布尔值，表示是否是第一次进入循环
  • forloop.last，也是一个布尔值，表示是否是最后一次进入循环
  • forloop.parentloop，表示上一级forloop变量，只在嵌套的for循环中有

4、ifequal/ifnotequal，比较两个值进行比较，看是否相等。可以有{% else %}，是以{% ifequal %}开始，以{% endifequal %}结束，其中比较的可以是变量、字符串、数字

{% ifequal section 'sitenews' %}
    <h1>Site News</h1>
{% else %}
    <h1>No News Here</h1>
{% endifequal %}
View Code

5、注释是由{# #}标签标注，是单行注释，也可以多行注释，使用{% comment %}块标签

{% comment %}
This is a
multi-line comment.
{% endcomment %}

三、创建独立模版文件

1、修改设置文件setting.py，需要添加存放template文件的目录

TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
os.path.join(BASE_DIR,'template'),
],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]

在'DIRS': []key中添加模版文件的目录。使用相对路径，因为之前已经导入过os，获得了工程目录是BASE_DIR，所以在该工程下创建一个template目录。用path的join()方法连接起来。

 

2、创建模版文件

current_time.html保存到template文件夹里

 1 <html>
 2 <head>
 3     <title>curentTime</title>
 4     
 5 </head>
 6 
 7 
 8 <body>
 9     <div>
10         <h1 style="color:red;">now is {{ now }} </h1>
11     </div>
12 </body>
13 </html>
View Code

在urlpatterns中添加

url(r'^now/$', views.GetTime),

在视图文件中添加对应的函数，在视图中用到了from django.template.loader 的get_template

1 def GetTime(request):
2     tm = time.strftime("%Y-%m-%d %H:%M:%S")
3     t = get_template('current_time.html');
4     html = t.render(Context({'now':tm}))
5     return HttpResponse(html);
View Code

此时便可以访问网址了http://127.0.0.1:8000/article/now/，效果如下

3、简便方法就是使用django.shortcuts的render()函数，不再需要从from django.template.loader import get_template,和from django.template import Context,和from django.http import HttpResponse.因为render函数自己会装载模版、产生Context和template rendering并且返回一个HttpResponse对象。

参数说明：第一个参数是request，第二个参数是template文件名，第三个参数，如果有，应当是一个字典用于产生Context对象，来替换模版内的内容；如果没有提供字典，则默认是一个空字典。

修改view视图。

def GetTime(request):
    tm = time.strftime("%Y-%m-%d %H:%M:%S")
    
    return render(request, 'current_time.html', {'now':tm})
View Code

 

四、模版的其他一些特性

1、{% include %}模版标签，意思是包含其他模版内容。标签的参数是要被包含的模版的文件名，可以是一个变量名或者硬编码的文件名字符串。

例如：

{% include 'nav.html' %}

{% include 'includes/nav.html' %}

{% include template_name %}

第一个表示包含模版内的nav.html文件，第二个是include文件夹下的nav.html文件，第三个是包含template_name变量的文件。

例子如下：

 1 # mypage.html
 2 
 3 <html>
 4 <body>
 5 {% include "includes/nav.html" %}
 6 <h1>{{ title }}</h1>
 7 </body>
 8 </html>
 9 
10 # includes/nav.html
11 
12 <div id="nav">
13     You are in: {{ current_section }}
14 </div>
View Code

 

注意：如果给的模版名没有找到，django的处理机制如下

  • If DEBUG is set to True, you’ll see the TemplateDoesNotExist exception on a Django error page.
  • If DEBUG is set to False, the tag will fail silently, displaying nothing in the place of the tag.

 

2、模版继承，主要用于解决模版中，大量重复性的工作，可以抽取出来，单独形成一个文件，然后通过包含或者继承解决。

就是通过将共用的内容，抽取出来形成单个文件，将不同的内容形成block块，然后进行填充。

例如一个html文件

 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <title>The current time</title>
 5     
 6 </head>
 7 
 8 
 9 <body>
10     <div>
11         <h1>My helpful timestamp site</h1>
12         <h1 style="color:red;">now is {{ now }} </h1>
13     </div>
14     <div>
15         <hr>
16         <p>Thanks for visiting my site.</p>
17     </div>
18 </body>
19 </html>
View Code

我们可以将其头部存储为header.html

<!DOCTYPE html>
<html>
<head>
View Code

将底部存储为footer.html

<hr>
    <p>Thanks for visiting my site.</p>
</body>
</html>
View Code

写一个模版框架，进行填充。下面是一个基模版，base.html

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}{% endblock %}</title>
    
</head>


<body>
    <p>this is current_time2.html file</p>
    <h1>My helpful time site</h1>
    {% block content %}{% endblock %}
    
    {% block footer%}
    <div>
        <hr>
        <p>Thanks for visiting my site.</p>
    </div>
    {% endblock %}
</body>
</html>
View Code

然后通过修改current_time.html文件，或者新建一个模版文件。为了方便，直接修改current_time.html文件，然后运行。修改后的文件如下：

{% extends "base.html"%}

{% block title %}the current time{% endblock %}

{% block content %}
<h1 style="color:red;text-align:center;">now is {{ now }} </h1>
{% endblock %}
View Code

工作流程：

首先加载current_time.html文件，看到{% extends %}说明这是一个子文件，模版引擎会加载父模版，在此为base.html

此时模版引擎看到{% block %}标签在base.html文件中，他将会用子模版中的内容进行替换。

如果没有在子模版中找到对应的block内容，会使用父模版中的内容替代。

在继承树中的模版，共享同一个Context对象。

3、模版继承的一些指导原则：

  • 如果使用{% extends %} 标签，它应当是模版的第一个标签，否则模版继承不会正常工作。
  • 在基模版中尽量多的使用{% block %}，然后再子模版中填充，因为，子模版仅需要填充那些你需要用的{%  block %}
  • 如果你经常复制一些代码，可以考虑使用一个{% block %}在父模版中
  • 如果需要使用父模版中的内容，{{ block.super }}将会提供父模版中的内容
  • {% extends %}中装载模版文件和get_template() 方法一样，会在setting.py文件中TEMPLATE_DIRS 连接在一块查找。因此，只需将extends的文件放在template制定的文件夹中即可。
  • {% extends %}和{% include %}模版标签一样，都可以使用字符串的硬编码来表示文件，也可以使用变量表示。
posted @ 2016-04-26 23:02  crazyCodeLove  阅读(356)  评论(0)  编辑  收藏  举报