(3)Django框架学习--模板篇

模板使用

模板基本由两个部分组成，一是HTML代码，二是逻辑控制代码。
逻辑控制的实现又基本由三个部分组成：
1. 变量的使用
{{ person_name }} #使用双大括号来引用变量
2. tag的使用
{% if ordered_warranty %} #使用大括号和百分号的组成来表示使用Django提供的
template tag
{% for item in item_list %}
<li>{{ item }}</li>
{% endfor %}
3. filter的使用
{{ ship_date|date:"F j, Y" }}，ship_date变量传给data过滤器，data过滤器通过使用
"F j, Y"这几个参数来格式化日期数据。"|"代表类似Unix命令中的管道操作。
 
Template system不仅仅可以和view进行合作，也可以自己独立使用。
最基本的使用方法是：
1. 使用模板代码字符串作为参数，创建一个Template类
2. 创建模板代码中所需要的上下文Context对象，包含所需要的各个引用参数的值
3. 调用Template.render()方法，把template渲染成一个完整的字符串。
>>> from django import template
>>> t = template.Template('My name is {{ name }}.')
>>> c = template.Context({'name': 'Adrian'})
>>> print t.render(c)
>>> My name is Adrian.
 
还可以在template代码中使用dict索引，然后在context传入所需要的dict
>>> 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.'
 
还可以使用函数，不过只能使用无参数的函数
>>> from django.template import Template, Context
>>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}')
>>> t.render(Context({'var': 'hello'}))
u'hello -- HELLO -- False'
 
还可以使用列表索引，但是item.-1是不被允许的
>>> 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.'
 
以上的使用方法被称为Dot Lookup方法。
 
使用dot lookup的访问函数功能时，需要注意的问题：
1. 当在模板代码中执行的函数抛出异常时，会一直向上层传播，除非这个异常中有一个参数
silent_variable_failure=True; 这样的话，这个出错的函数信息就会被渲染成空字符串。
>>> class SilentAssertionError(AssertionError):
... silent_variable_failure = True
>>> class PersonClass4:
... def first_name(self):
... raise SilentAssertionError
>>> p = PersonClass4()
>>> t.render(Context({"person": p}))
u'My name is .'
 
2. 很明显，调用函数会产生一些不好的结果，安全漏洞之类的，如果你有一个BankAccout，
然后在模板中写成{{ account.delete }}， 这样在渲染的时候，你的账号就被删除了。。。。
所以要在修改一下你的delete函数
def delete(self):
# Delete the account
delete.alters_data = True#缩进没有问题，把delete看成一个对象，设置它的alters_data属性。
这样在渲染的时候，就会变成failed silent。
 
当在渲染的时候，简单的key值没有找到时，会failed silent，变成空字符串，而不是大动干戈的
报错。
>>> from django.template import Template, Context
>>> t = Template('Your name is {{ name }}.')
>>> t.render(Context())
u'Your name is .'
>>> t.render(Context({'var': 'hello'}))
u'Your name is .'
 
Context对象也可以进行增删改值的操作。
>>> from django.template import Context
>>> c = Context({"foo": "bar"})
>>> c['foo']
'bar'
>>> c['newvariable'] = 'hello'
>>> del c['foo']
>>> c['foo']
 
使用python manage.py shell启动python交互式命令行窗口与一般直接启动python自带的
交互式命令行窗口的区别是前者会通过找一个DJANGO_SETTINGS_MODULE环境变量，
告诉Django导入settings.py的配置信息。
 

基本的tag和filter的用法

tag:
  • {% if %}的使用
可以使用and, or, not来组织你的逻辑。但不允许and和or同时出现的条件语句中。
没有{% elif %}这样的用法，只能用嵌套来实现多重if语句。
{% if athlete_list %}
<p>Here are the athletes: {{ athlete_list }}.</p>
{% else %}
<p>No athletes are available.</p>
{% if not coach_list %}
<p>Here are the coaches: {{ coach_list }}.</p>
{% endif %}
{% endif %}
  • {% for %} 的使用
用来循环一个list，还可以使用resersed关键字来进行倒序遍历，一般可以用if语句来先
判断一下列表是否为空，再进行遍历；还可以使用empty关键字来进行为空时候的跳转。
{% for athlete in athlete_list resersed %}
<li>{{ athlete.name }}</li>
{% empty %}
<p>There are no athletes. Only computer programmers.</p>
{% endfor %}
 
for tag还提供了一些内置参数来提供模板循环的信息。
1. forloop.counter 当前循环计数，从1开始
{% for item in todo_list %}
<p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}
2. forloop.counter0 当前循环计数，从0开始，标准索引方式
3. forloop.revcounter 当前循环的倒数计数，从列表长度开始
4. forloop.revcounter0 当前循环的倒数计数，从列表长度减1开始，标准
5. forloop.first bool值，判断是不是循环的第一个元素
6. forloop.last 同上，判断是不是循环的最后一个元素
7. forloop.parentloop 用在嵌套循环中，得到parent循环的引用，然后可以使用以上的参数
{% for country in countries %}
<table>
{% for city in country.city_list %}
<tr>
<td>Country #{{ forloop.parentloop.counter }}</td>
<td>City #{{ forloop.counter }}</td>
<td>{{ city }}</td>
</tr>
{% endfor %}
</table>
{% endfor %}
  • ifequal和ifnotequal，一看就是直接比较值的tag，需要两个参数，用法比较有限，
  • 只限于字符串，整数，小数的比较，什么列表，字典，元组不支持。
{% ifequal user currentuser %}
<h1>Welcome!</h1>
{% ifequal section "community" %}
<h1>Community</h1>
{% endifequal %}
{% endifequal %}
  • {# #}，模板中注释的用法，只能用在一行
  • 如果要使用多行注释，要使用{% comment %}
{# This is a comment #}
{% comment %}
This is a
multi-line comment.
{% endcomment %}
filter:
filter用于变量在显示之前的一些简单的处理。使用类似管道的操作符"|"，也可以进行链式操作
{{ name|lower }}
{{ my_list|first|upper }}
{{ bio|truncatewords:"30" }}
介绍几个重要的filter:
  • addslashes :给任何的反斜线，单引号，双引号，再加一个反斜线。在文本中含有javascript字符串的时候有用。
  • date :用来对data和datatime对象的字符串信息进行格式化。
  • {{ pub_date|date:"F j, Y" }}
  • length :返回变量的长度。

在view中使用template：

首先在settings.py中配置模板文件的路径。
TEMPLATE_DIRS = (
'/home/django/mysite/templates',
)
记住一个路径的时候要使用逗号，这样是来区分是一个tuple还是一个block expression
也可以在设置的时候使用python文件路径操作代码：
import os.path
 
TEMPLATE_DIRS = (
os.path.join(os.path.dirname(__file__), 'templates').replace('\\','/'),
)
 
然后，可以在view中使用模板
from django.template.loader import get_template
from django.template import Context
from django.http import HttpResponse
import datetime

def current_datetime(request):
now = datetime.datetime.now()
t = get_template('current_datetime.html')
html = t.render(Context({'current_date': now}))
return HttpResponse(html)
 
大多数情况下，你会使用一种shortcut方法，render_to_response()去完成以上的工作。
from django.shortcuts import render_to_response
import datetime

def current_datetime(request):
now = datetime.datetime.now()
return render_to_response('current_datetime.html', {'current_date': now})
 
locals()的小技巧
如果你有很多变量要传给render，一个一个构造dict元素很麻烦。直接把变量名改成模板中所需要的变量名，
再使用locasl()函数，轻松搞定
def current_datetime(request):
current_date = datetime.datetime.now()
return render_to_response('current_datetime.html', locals())
locals()会返回局部空间中变量信息的dict，直接可以传给render，但有一点需要注意，它会返回把有的局部变量
信息，有一些可能不需要用到，如request变量。
 
{% include %}的使用
{% include 'nav.html' %}，用来引入其它模板的内容，减少重复的模板代码
{% include template_name %}，还可以使用变量名
如果include的模板文件没有找到，当DEBUG为真时，会报错TemplateDoesNotExist，当为假时，页面那一块为
空白。
 
诚然，include可以有效减少模板的重复代码。但一种更优雅的方式是：
template inheritance.
首先，创建base.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
<title>{% block title %}{% endblock %}</title>
</head>
<body>
<h1>My helpful timestamp site</h1>
{% block content %}{% endblock %}
{% block footer %}
<hr>
<p>Thanks for visiting my site.</p>
{% endblock %}
</body>
</html>
 
我们使用一个新的tag，{% block %}用来告诉template engine，这个部分会被子模板
来实现。如果子模板没有实现这些部分，就会默认使用父模板的代码。
 
再看看，子模板要怎么写：
{% extends "base.html" %}
 
{% block title %}The current time{% endblock %}
 
{% block content %}
<p>It is now {{ current_date }}.</p>
{% endblock %}
只需要先使用{% extends %}继承父模板，再把相应需要实现的部分写上所需要的内容。
 
{% extends template_name %}也可以使用变量名来实现动态。
模板继承的三层继承策略：
1. 创建一个base.html，用来设置外观
2. 为网站的每一个部分，创建base_SECTION.html，比如base_phote.html, base_forum.html
3. 为每一个页面创建自己的模板。
 





posted @ 2012-08-29 17:18  btchenguang  阅读(10920)  评论(0)  编辑  收藏  举报