Eclipse的django開發學習筆記（4）--模板（V）

模板

是一個獨立的文本文件，同時包含了靜態內容和動態標記的邏輯、循環和數據的顯示；
模板一般被用來生成HTML，也能夠生成log文件E-mail文件，csv文件等任何文本格式；

模板渲染過程：

>>> from django.template import Context, Template
>>> t = Template('My name is {{ name }}.')
>>> c = Context({'name': 'Stephane'})
>>> t.render(c)
u'My name is Stephane.'

Contexts

Django裏把傳給一個渲染模板的信息成爲contexts，基本上是一個包含鍵值對的字典，
在渲染時表表示了一個相似字典的Context對象；

語法：

變量： 雙括號 {{obj.name}}
判斷:
{% if athlete_list %}
    Number of athletes: {{ athlete_list|length }}
{% else %}
    No athletes.
{% endif %}

{% ifequal athlete.name coach.name %}
    ...
{% endifequal %}

{% ifnotequal athlete.name "Joe" %}
    ...
{% endifnotequal %}

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

{% for key, value in data.items %}
    {{ key }}: {{ value }}
{% endfor %}

循環中的常量使用（摘自django book）：

forloop.counter 老是一個表示當前循環的執行次數的整數計數器。
這個計數器是從1開始的，因此在第一次循環時 forloop.counter 將會被設置爲1。
{% for item in todo_list %}
    <p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}
forloop.counter0 相似於 forloop.counter ，可是它是從0計數的。 第一次執行循環時這個變量會被設置爲0。
forloop.revcounter 是表示循環中剩餘項的整型變量。 在循環初次執行時 forloop.revcounter 將被設置爲序列中項的總數。 最後一次循環執行中，這個變量將被置1。
forloop.revcounter0 相似於 forloop.revcounter ，但它以0作爲結束索引。在第一次執行循環時，該變量會被置爲序列的項的個數減1。
forloop.first 是一個布爾值。
在第一次執行循環時該變量爲True，在下面的情形中這個變量是頗有用的。
{% for object in objects %}
    {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}
    {{ object }}
    </li>
{% endfor %}
forloop.last 是一個布爾值；在最後一次執行循環時被置爲True。
一個常見的用法是在一系列的連接之間放置管道符（|）
{% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}
上面的模板可能會產生以下的結果：
Link1 | Link2 | Link3 | Link4
另外一個常見的用途是爲列表的每一個單詞的加上逗號。
Favorite places:
{% for p in places %}{{ p }}{% if not forloop.last %}, {% endif %}{% endfor %}
forloop.parentloop 是一個指向當前循環的上一級循環的 forloop 對象的引用（在嵌套循環的狀況下）。
例子在此：
{% 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 %}
forloop 變量僅僅可以在循環中使用，在模板解析器碰到 {% endfor %} 標籤時， forloop 就不可訪問了。 模板的語法分析器在遇到{% endfor %}標籤後，就會結束 forloop循環。

 註釋：

單行註釋 {# This is a comment #}
多行註釋

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

模板過濾器

相似UNIX的管道，使用符號 | 來轉換context的變量；

數據的過濾器：

apnumber
對於 1 到 9 的數字，該過濾器返回了數字的拼寫形式。 不然，它將返回數字。 這遵循的是美聯社風格。
舉例：
1 變成 one 。
2 變成 two 。
10 變成 10 。
你能夠傳入一個整數或者表示整數的字符串。

intcomma
該過濾器將整數轉換爲每三個數字用一個逗號分隔的字符串。
Examples:
4500 變成 4,500 。
45000 變成 45,000 。
450000 變成 450,000 。
4500000 變成 4,500,000 。

intword
該過濾器將一個很大的整數轉換成友好的文本表示方式。 它對於超過一百萬的數字最好用。
Examples:
1000000 變成 1.0 million 。
1200000 變成 1.2 million 。
1200000000 變成 1.2 billion 。

最大支持不超過一千的五次方（1,000,000,000,000,000）。

ordinal
該過濾器將整數轉換爲序數詞的字符串形式。
Examples:
1 變成 1st 。
2 變成 2nd 。
3 變成 3rd 。

另：

html頁面從數據庫中讀出DateTimeField字段時，顯示的時間格式和數據庫中存放的格式不一致，好比數據庫字段內容爲2012-08-26 16:00:00，可是頁面顯示的倒是Aug. 26, 2012, 4 p.m.

爲了頁面和數據庫中顯示一致，須要在頁面格式化時間，須要添加<td>{{ dayrecord.p_time|date:"Y-m-d H:i:s" }}</td> 相似的過濾器。刷新頁面，便可正常顯示。

 

過濾器相關：

1、形式：小寫
{{ name | lower }}

2、串聯：先轉義文本到HTML，再轉換每行到 <p> 標籤
{{ my_text|escape|linebreaks }}

3、過濾器的參數
顯示前30個字
{{ bio | truncatewords:"30" }}

格式化
{{ pub_date | date:"F j, Y" }}

過濾器列表
{{ 123|add:"5" }} 給value加上一個數值
{{ "AB'CD"|addslashes }} 單引號加上轉義號，通常用於輸出到javascript中
{{ "abcd"|capfirst }} 第一個字母大寫
{{ "abcd"|center:"50" }} 輸出指定長度的字符串，並把值對中
{{ "123spam456spam789"|cut:"spam" }} 查找刪除指定字符串
{{ value|date:"F j, Y" }} 格式化日期
{{ value|default:"(N/A)" }} 值不存在，使用指定值
{{ value|default_if_none:"(N/A)" }} 值是None，使用指定值
{{ 列表變量|dictsort:"數字" }} 排序從小到大
{{ 列表變量|dictsortreversed:"數字" }} 排序從大到小
{% if 92|divisibleby:"2" %} 判斷是否整除指定數字

{{ string|escape }} 轉換爲html實體
{{ 21984124|filesizeformat }} 以1024爲基數，計算最大值，保留1位小數，增長可讀性
{{ list|first }} 返回列表第一個元素
{{ "ik23hr&jqwh"|fix_ampersands }} &轉爲&amp;
{{ 13.414121241|floatformat }} 保留1位小數，可爲負數，幾種形式
{{ 13.414121241|floatformat:"2" }} 保留2位小數
{{ 23456 |get_digit:"1" }} 從個位數開始截取指定位置的1個數字

{{ list|join:", " }} 用指定分隔符鏈接列表
{{ list|length }} 返回列表個數
{% if 列表|length_is:"3" %} 列表個數是否指定數值
{{ "ABCD"|linebreaks }} 用新行用<p> 、 <br /> 標記包裹
{{ "ABCD"|linebreaksbr }} 用新行用<br /> 標記包裹
{{ 變量|linenumbers }} 爲變量中每一行加上行號
{{ "abcd"|ljust:"50" }} 把字符串在指定寬度中對左，其它用空格填充

{{ "ABCD"|lower }} 小寫
{% for i in "1abc1"|make_list %}ABCDE,{% endfor %} 把字符串或數字的字符個數做爲一個列表
{{ "abcdefghijklmnopqrstuvwxyz"|phone2numeric }} 把字符轉爲能夠對應的數字？？
{{ 列表或數字|pluralize }} 單詞的複數形式，如列表字符串個數大於1，返回s，不然返回空串

{{ 列表或數字|pluralize:"es" }} 指定es
{{ 列表或數字|pluralize:"y,ies" }} 指定ies替換爲y
{{ object|pprint }} 顯示一個對象的值
{{ 列表|random }} 返回列表的隨機一項
{{ string|removetags:"br p div" }} 刪除字符串中指定html標記
{{ string|rjust:"50" }} 把字符串在指定寬度中對右，其它用空格填充

{{ 列表|slice:":2" }} 切片
{{ string|slugify }} 字符串中留下減號和下劃線，其它符號刪除，空格用減號替換
{{ 3|stringformat:"02i" }} 字符串格式，使用Python的字符串格式語法
{{ "E<A>A</A>B<C>C</C>D"|striptags }} 剝去[X]HTML語法標記
{{ 時間變量|time:"P" }} 日期的時間部分格式
{{ datetime|timesince }} 給定日期到如今過去了多少時間
{{ datetime|timesince:"other_datetime" }} 兩日期間過去了多少時間

{{ datetime|timeuntil }} 給定日期到如今過去了多少時間，與上面的區別在於2日期的先後位置。
{{ datetime|timeuntil:"other_datetime" }} 兩日期間過去了多少時間
{{ "abdsadf"|title }} 首字母大寫
{{ "A B C D E F"|truncatewords:"3" }} 截取指定個數的單詞
{{ "<a>1<a>1<a>1</a></a></a>22<a>1</a>"|truncatewords_html:"2" }} 截取指定個數的html標記，並補完整
<ul>{{ list|unordered_list }}</ul> 多重嵌套列表展示爲html的無序列表

{{ string|upper }} 所有大寫
<a href="{{ link|urlencode }}">linkage</a> url編碼
{{ string|urlize }} 將URLs由純文本變爲可點擊的連接。（沒有實驗成功）
{{ string|urlizetrunc:"30" }} 同上，多個截取字符數。（一樣沒有實驗成功）

{{ "B C D E F"|wordcount }} 單詞數
{{ "a b c d e f g h i j k"|wordwrap:"5" }} 每指定數量的字符就插入回車符
{{ boolean|yesno:"Yes,No,Perhaps" }} 對三種值的返回字符串，對應是 非空,空,None

 

日期格式化參數：

a 'a.m.' 或 'p.m.' (注意,它與PHP 的輸出略有不一樣.它包括了句點(django擴展). 'a.m.' 
A 'AM' 或 'PM'. 'AM' 
B 未實現.   
d 每個月第幾天, 帶前導零 '01' to '31' 
D 每週第幾天,3字母的字符串. 'Fri' 
f 時間, 12-小時制的小時和分鐘數, 若是分鐘數爲零,則不顯示.(django 擴展). '1', '1:30' 
F 月份, 長文本格式. 'January' 
g 小時, 12-小時制,沒有前導零 '1' to '12' 
G 小時, 24-小時制,沒有前導零 '0' to '23' 
h 小時, 12-小時制,有前導零 '01' to '12' 
H 小時, 24-小時制,有前導零 '00' to '23' 
i 分鐘. '00' to '59' 
I 未實現   
j 每個月第幾天, 無前導零 '1' to '31' 
l 每週第幾天,長文本格式. 'Friday' 
L 是否閏年. True or False 
m 數字表示的月份,有前導零. '01' to '12' 
M 月份,3字母短文本格式. 'Jan' 
n 數字表示的月份,無前導零 '1' to '12' 
N 出版風格的月份縮寫(django 擴展) 'Jan.', 'Feb.', 'March', 'May' 
O 與格林威治的時間差(以小時計) '+0200' 
P 12小時制的小時分鐘及'a.m.'/'p.m.' 分鐘數若爲零則不顯示. 用字符串表示特殊 的時間點, 如 'midnight' 和 'noon' (django擴展) '1 a.m.', '1:30 p.m.', 'midnight','noon', '12:30 p.m.' 
r RFC 822 格式的日期 . 'Thu, 21 Dec 2000 16:01:07+0200' 
s 秒數, 帶有前導零的數字表示 '00' to '59' 
S 英語序數後綴,用於一個月的第幾天,2個字符 'st', 'nd', 'rd' or 'th' 
t 給定月共有多少天. 28 to 31 
T 本機時區. 'EST', 'MDT' 
U 未實現   
w 一週中的第幾天,沒有前導零的數字 '0' (Sunday) to '6' (Saturday) 
W ISO-8601 一年的第多少星期數, 一週從 星期一開始 1, 23 
y Year, 2 位數字表示 '99' 
Y Year, 4 位數字表示 '1999' 
z 一年中的第幾天 . 0 to 365 
Z 以秒計的時區偏移量. 這個偏移量對UTC西部 時區老是負數,而對UTC東部時區則老是正數 -43200 to 43200

模板繼承

{% extends "test1.html"%}

模板包含：

{% include "test1.html"%}

 其餘 ：

一、帶有alter_data 標記的方法在模板中將不被執行：

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

若是模板文件裏包含了 {{ account.delete }} ，對象又具備 delete()方法，並且delete() 有alters_data=True這個屬性，那麼在模板載入時， delete()方法將不會被執行。 它將靜靜地錯誤退出。 

二、捷徑

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})

同：

使用django的自動模板加載，須要配置 TEMPLATE_DIRS。

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)

不用使用模板自動加載，

from django.template import Template, Context
from django.http import HttpResponse
import datetime

def current_datetime(request):
    now = datetime.datetime.now()
    # Simple way of using templates from the filesystem.
    # This is BAD because it doesn't account for missing files!
    fp = open('/home/djangouser/templates/mytemplate.html')
    t = Template(fp.read())
    fp.close()
    html = t.render(Context({'current_date': now}))
    return HttpResponse(html)