常用的語(yǔ)法
在DjangoHong Kong只需要記兩種特殊符號(hào):
-
{{ }}:變量相關(guān) -
{% %}: 邏輯相關(guān)
變量
在Django模板語(yǔ)言中使用:{{變量名}}.
當(dāng)模板引擎遇到一個(gè)變量它將計(jì)算這個(gè)變量，然后用結(jié)果替換掉它本身。 變量的命名包括任何字母數(shù)字以及下劃線 ("_")的組合。 變量名稱(chēng)中不能有空格或標(biāo)點(diǎn)符號(hào)。
點(diǎn)（.）在模板語(yǔ)言中有特殊的含義。當(dāng)模版系統(tǒng)遇到點(diǎn)(".")，它將以這樣的順序查詢(xún)
字典查詢(xún)（Dictionary lookup）
屬性或方法查詢(xún)（Attribute or method lookup）
數(shù)字索引查詢(xún)（Numeric index lookup）
注意
1.如果計(jì)算結(jié)果的值是可調(diào)用的，它將被無(wú)參數(shù)的調(diào)用。 調(diào)用的結(jié)果將成為模版的值。
- 如果使用的變量不存在， 模版系統(tǒng)將插入 string_if_invalid 選項(xiàng)的值， 它被默認(rèn)設(shè)置為'' (空字符串) 。
例子
view.py里的代碼
from django.shortcuts import render
# Create your views here.
def t(request):
d1 = {'name':'xxs','age':19,'items':'hhh'}
class Person:
def __init__(self,name,age):
self.name = name
self.age = age
@staticmethod
def dream():
return 'hello word'
xyh = Person('xyh',30)
list1 = ['dq','ffe','dsf','gre','wer']
p1 = Person('yhl',18)
p2 = Person('hsh',78)
p3 = Person('ww',68)
list2 = [p1,p2,p3]
return render(request,'t.html',{'name':'xxx','age':23,'d1':d1,'sb':xyh,'li':list1,'list2':list2})
HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Django模板語(yǔ)言</title>
</head>
<body>
<p>{{ name }}</p>
<p>{{ age }}</p>
<hr>
<h3>字典按key取值</h3>
<p>{{ d1.name }}</p>
<p>{{ d1.age }}</p>
<h3>屬性或key和方法重名優(yōu)先顯示屬性或KEY</h3>
<p>{{ d1.items }}</p>
<hr>
<h3>對(duì)象.屬性</h3>
<p>{{ sb.name }}</p>
<p>{{ sb.age }}</p>
<h3>對(duì)象.方法 不用加括號(hào)</h3>
<p>{{ sb.dream }}</p>
<hr>
<h3>列表按索引取值</h3>
<p>{{ li.2 }}</p>
<hr>
<h3>支持鏈?zhǔn)讲僮?lt;/h3>
<p>{{ list2.1.name }}</p>
<p>{{ list2.1.age }}</p>
</body>
</html>
結(jié)果:
Filters(過(guò)濾器)
在Django的模板語(yǔ)言中，通過(guò)使用 過(guò)濾器 來(lái)改變變量的顯示。
語(yǔ)法:{{ value|filter_name:參數(shù) }}
參數(shù)
-
value是變量名 -
|是管道符 -
filter_name:參數(shù)是過(guò)濾器名和參數(shù)例:{{ name|lower }}會(huì)將name變量應(yīng)用lower過(guò)濾器之后再顯示它的值。lower在這里的作用是將文本全都變成小寫(xiě)。
注意
1.過(guò)濾器支持“鏈?zhǔn)健辈僮?。即一個(gè)過(guò)濾器的輸出作為另一個(gè)過(guò)濾器的輸入。
2.過(guò)濾器可以接受參數(shù)，例如：{{ sss|truncatewords:30 }}，這將顯示sss的前30個(gè)詞。
3.過(guò)濾器參數(shù)包含空格的話，必須用引號(hào)包裹起來(lái)。比如使用逗號(hào)和空格去連接一個(gè)列表中的元素，如：{{ list|join:', ' }}
4.'|'左右沒(méi)有空格沒(méi)有空格沒(méi)有空格
常用的內(nèi)置過(guò)濾器
我們先在view.py文件里邊寫(xiě)好要傳的內(nèi)容:
from django.shortcuts import render
from datetime import datetime,timedelta
def t2(request):
name = 'xyh'
file_size = 4325435346432
now = datetime.now() # 獲取一個(gè)datatime類(lèi)型的時(shí)間
a = '<a href="heeps://www.4399.com">4399</a>'
p = '''
只有經(jīng)歷過(guò)地獄般的磨礪，才能練就創(chuàng)造天堂的力量；
只有流過(guò)血的手指，才能彈出世間的絕響。
只有經(jīng)歷過(guò)地獄般的磨礪，才能練就創(chuàng)造天堂的力量；
只有流過(guò)血的手指，才能彈出世間的絕響。
縱然傷心，也不要愁眉不展，因?yàn)槟悴恢钦l(shuí)會(huì)愛(ài)上你的笑容。
'''
p2 = 'aledfaaalfd'
list = ['dq','ffe','dsf','gre','wer']
# 獲取5小時(shí)之前的時(shí)間
l = now - timedelta(hours=5)
return render(request,
't2.html',
{
'name':name,
'file_size':file_size,
'now':now,
'a':a,
'p': p,
'p2': p2,
'list':list,
'l' : l
}
)
default
如果一個(gè)變量是false或者為空，使用給定的默認(rèn)值。 否則，使用變量的值。
如果value沒(méi)有傳值或者值為空的話就顯示nothing
{{ value|default:"默認(rèn)值"}}
結(jié)果:
length
返回值的長(zhǎng)度，作用于字符串和列表。
{{ value|length} }
結(jié)果:
filesizeformat
將值格式化為一個(gè) “人類(lèi)可讀的” 文件尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等）。例如：
{{ value|filesizeformat }}
結(jié)果:
slice
切片
{{value|slice:"2:-1"}}
結(jié)果:
data
時(shí)間格式化
{{ value|date:"Y-m-d H:i:s"}}
可用的參數(shù):
| 格式化字符 | 描述 | 示例輸出 |
|---|---|---|
| a |
'a.m.'或'p.m.'（請(qǐng)注意，這與PHP的輸出略有不同，因?yàn)檫@包括符合Associated Press風(fēng)格的期間） |
'a.m.' |
| A |
'AM'或'PM'。 |
'AM' |
| b | 月，文字，3個(gè)字母，小寫(xiě)。 | 'jan' |
| B | 未實(shí)現(xiàn)。 | |
| c | ISO 8601格式。 （注意：與其他格式化程序不同，例如“Z”，“O”或“r”，如果值為naive datetime，則“c”格式化程序不會(huì)添加時(shí)區(qū)偏移量（請(qǐng)參閱datetime.tzinfo） 。 |
2008-01-02T10:30:00.000123+02:00或2008-01-02T10:30:00.000123如果datetime是天真的 |
| d | 月的日子，帶前導(dǎo)零的2位數(shù)字。 |
'01'到'31'
|
| D | 一周中的文字，3個(gè)字母。 | “星期五” |
| e | 時(shí)區(qū)名稱(chēng) 可能是任何格式，或者可能返回一個(gè)空字符串，具體取決于datetime。 |
''、'GMT'、'-500'、'US/Eastern'等 |
| E | 月份，特定地區(qū)的替代表示通常用于長(zhǎng)日期表示。 |
'listopada'（對(duì)于波蘭語(yǔ)區(qū)域，而不是'Listopad'） |
| f | 時(shí)間，在12小時(shí)的小時(shí)和分鐘內(nèi)，如果它們?yōu)榱悖瑒t分鐘停留。 專(zhuān)有擴(kuò)展。 |
'1'，'1:30'
|
| F | 月，文，長(zhǎng)。 | '一月' |
| g | 小時(shí)，12小時(shí)格式，無(wú)前導(dǎo)零。 |
'1'到'12'
|
| G | 小時(shí)，24小時(shí)格式，無(wú)前導(dǎo)零。 |
'0'到'23'
|
| h | 小時(shí)，12小時(shí)格式。 |
'01'到'12'
|
| H | 小時(shí)，24小時(shí)格式。 |
'00'到'23'
|
| i | 分鐘。 |
'00'到'59'
|
| I | 夏令時(shí)間，無(wú)論是否生效。 |
'1'或'0'
|
| j | 沒(méi)有前導(dǎo)零的月份的日子。 |
'1'到'31'
|
| l | 星期幾，文字長(zhǎng)。 | '星期五' |
| L | 布爾值是否是一個(gè)閏年。 |
True或False
|
| m | 月，2位數(shù)字帶前導(dǎo)零。 |
'01'到'12'
|
| M | 月，文字，3個(gè)字母。 | “揚(yáng)” |
| n | 月無(wú)前導(dǎo)零。 |
'1'到'12'
|
| N | 美聯(lián)社風(fēng)格的月份縮寫(xiě)。 專(zhuān)有擴(kuò)展。 |
'Jan.'，'Feb.'，'March'，'May'
|
| o | ISO-8601周編號(hào)，對(duì)應(yīng)于使用閏年的ISO-8601周數(shù)（W）。 對(duì)于更常見(jiàn)的年份格式，請(qǐng)參見(jiàn)Y。 | '1999年' |
| O | 與格林威治時(shí)間的差異在幾小時(shí)內(nèi)。 | '+0200' |
| P | 時(shí)間為12小時(shí)，分鐘和'a.m。'/'p.m。'，如果為零，分鐘停留，特殊情況下的字符串“午夜”和“中午”。 專(zhuān)有擴(kuò)展。 |
'1 am'，'1:30 pm' / t3>，'midnight'，'noon'，'12：30 pm' / T10>`` |
| r | RFC 5322格式化日期。 | 'Thu, 21 Dec 2000 16:01:07 +0200' |
| s | 秒，帶前導(dǎo)零的2位數(shù)字。 |
'00'到'59'
|
| S | 一個(gè)月的英文序數(shù)后綴，2個(gè)字符。 |
'st'，'nd'，'rd'或'th'
|
| t | 給定月份的天數(shù)。 |
28 to 31
|
| T | 本機(jī)的時(shí)區(qū)。 |
'EST'，'MDT'
|
| u | 微秒。 |
000000 to 999999
|
| U | 自Unix Epoch以來(lái)的二分之一（1970年1月1日00:00:00 UTC）。 | |
| w | 星期幾，數(shù)字無(wú)前導(dǎo)零。 |
'0'（星期日）至'6'（星期六） |
| W | ISO-8601周數(shù)，周數(shù)從星期一開(kāi)始。 |
1，53
|
| y | 年份，2位數(shù)字。 | '99' |
| Y | 年，4位數(shù)。 | '1999年' |
| z | 一年中的日子 |
0到365
|
| Z | 時(shí)區(qū)偏移量，單位為秒。UTC以西時(shí)區(qū)的偏移量總是為負(fù)數(shù)，對(duì)于UTC以東時(shí)，它們總是為正。 |
-43200到43200
|
結(jié)果:
safe
Django的模板中會(huì)對(duì)HTML標(biāo)簽和JS等語(yǔ)法標(biāo)簽進(jìn)行自動(dòng)轉(zhuǎn)義，原因顯而易見(jiàn)，這樣是為了安全。但是有的時(shí)候我們可能不希望這些HTML元素被轉(zhuǎn)義，比如我們做一個(gè)內(nèi)容管理系統(tǒng)，后臺(tái)添加的文章中是經(jīng)過(guò)修飾的，這些修飾可能是通過(guò)一個(gè)類(lèi)似于FCKeditor編輯加注了HTML修飾符的文本，如果自動(dòng)轉(zhuǎn)義的話顯示的就是保護(hù)HTML標(biāo)簽的源文件。為了在Django中關(guān)閉HTML的自動(dòng)轉(zhuǎn)義有兩種方式，如果是一個(gè)單獨(dú)的變量我們可以通過(guò)過(guò)濾器“|safe”的方式告訴Django這段代碼是安全的不必轉(zhuǎn)義。
{{ value|safe}}
結(jié)果:
truncatechars和truncatewords
如果字符串字符多于指定的字符數(shù)量，那么會(huì)被截?cái)唷＝財(cái)嗟淖址畬⒁钥煞g的省略號(hào)序列（“...”）結(jié)尾。
參數(shù)：截?cái)嗟淖址麛?shù)
{{ value|truncatechars:9}}
在一定數(shù)量的字后截?cái)嘧址?br>
{{ value|truncatewords:9}}
結(jié)果:
cut
移除value中所有的與給出的變量相同的字符串
{{ value|cut:' ' }}
結(jié)果:
join
使用字符串連接列表，例如Python的str.join(list)
結(jié)果:
timesince
將日期格式設(shè)為自該日期起的時(shí)間（例如，“4天，6小時(shí)”）。
采用一個(gè)可選參數(shù)，它是一個(gè)包含用作比較點(diǎn)的日期的變量（不帶參數(shù)，比較點(diǎn)為現(xiàn)在）。 例如，如果blog_date是表示2006年6月1日午夜的日期實(shí)例，并且comment_date是2006年6月1日08:00的日期實(shí)例，則以下將返回“8小時(shí)”：
{{ blog_date|timesince:comment_date }}
分鐘是所使用的最小單位，對(duì)于相對(duì)于比較點(diǎn)的未來(lái)的任何日期，將返回“0分鐘”。
結(jié)果:
自定義filter
自定義過(guò)濾器只是帶有一個(gè)或兩個(gè)參數(shù)的Python函數(shù):
- 變量（輸入）的值 - -不一定是一個(gè)字符串
- 參數(shù)的值 - 這可以有一個(gè)默認(rèn)值，或完全省略
自定義步驟
-
在app下面新建一個(gè)python package名字叫templatetags
創(chuàng)建templatetags包 -
在上一步的python package中新建一個(gè)py文件
創(chuàng)建py文件 在py文件中寫(xiě)一個(gè)函數(shù)，實(shí)現(xiàn)自定義的filter功能
def sb(value):
return value + 'sb'
- 告訴Django我現(xiàn)在多了一個(gè)自定義的filter
from django import template
register = template.Library()
@register.filter()
def sb(value):
return value + 'sb'
使用步驟
-
在HTML文件中導(dǎo)入剛才創(chuàng)建的py文件
導(dǎo)入文件
{% load s1 %}
- 重啟Django項(xiàng)目
- 按照普通的filter調(diào)用自定義的函數(shù)
Tags
for循環(huán)
普通for循環(huán)
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% endfor %}
</ul>
for循環(huán)可用的一些參數(shù)：
| Variable | Description |
|---|---|
| forloop.counter | 當(dāng)前循環(huán)的索引值（從1開(kāi)始） |
| forloop.counter0 | 當(dāng)前循環(huán)的索引值（從0開(kāi)始） |
| forloop.revcounter | 當(dāng)前循環(huán)的倒序索引值（從1開(kāi)始） |
| forloop.revcounter0 | 當(dāng)前循環(huán)的倒序索引值（從0開(kāi)始） |
| forloop.first | 當(dāng)前循環(huán)是不是第一次循環(huán)（布爾值） |
| forloop.last | 當(dāng)前循環(huán)是不是最后一次循環(huán)（布爾值） |
| forloop.parentloop | 本層循環(huán)的外層循環(huán) |
for ... empty
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% empty %}
<li>空空如也</li>
{% endfor %}
</ul>
if判斷
if,elif和else
{% if user_list %}
用戶(hù)人數(shù)：{{ user_list|length }}
{% elif black_list %}
黑名單數(shù)：{{ black_list|length }}
{% else %}
沒(méi)有用戶(hù)
{% endif %}
當(dāng)然也可以只有if和else
{% if user_list|length > 5 %}
七座豪華SUV
{% else %}
黃包車(chē)
{% endif %}
if語(yǔ)句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判斷.
with
定義一個(gè)中間變量，多用于給一個(gè)復(fù)雜的變量起別名。
注意等號(hào)左右不要加空格。
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
或
{% with business.employees.count as total %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
csrf_token
這個(gè)標(biāo)簽用于跨站請(qǐng)求偽造保護(hù)。
在頁(yè)面的form表單里面寫(xiě)上{% csrf_token %}
注釋
{# ... #}
注意事項(xiàng)
- Django的模板語(yǔ)言不支持連續(xù)判斷，即不支持以下寫(xiě)法：
{% if a > b > c %}
...
{% endif %}
- Django的模板語(yǔ)言中屬性的優(yōu)先級(jí)大于方法
def xx(request):
d = {"a": 1, "b": 2, "c": 3, "items": "100"}
return render(request, "xx.html", {"data": d})
如上，我們?cè)谑褂胷ender方法渲染一個(gè)頁(yè)面的時(shí)候，傳的字典d有一個(gè)key是items并且還有默認(rèn)的 d.items() 方法，此時(shí)在模板語(yǔ)言中:
{{ data.items }}
默認(rèn)會(huì)取d的items key的值
自定義Tag
和自定義filter類(lèi)似,創(chuàng)建的步驟也一樣(如何創(chuàng)建和應(yīng)用參考自定義filter),但是tag更靈活
simple_tag
- 處理復(fù)雜邏輯的自定義功能
- 寫(xiě)法同自定義filter類(lèi)似
自定義方法:
from django import template
register = template.Library() # 生成一個(gè)注冊(cè)的實(shí)例對(duì)象
@register.simple_tag(name="自定義名字(可以不寫(xiě))") # 定義注冊(cè)simple_tag
def 函數(shù)名(參數(shù)):
return 結(jié)果
使用:
{% load .py文件名%}
{%自定義Tag名字 參數(shù) %}
例:
from django import template
register = template.Library() # 生成一個(gè)注冊(cè)的實(shí)例對(duì)象
@register.simple_tag()
def se(arg1,arg2):
return arg1 + arg2
<h3>自定義的simple_tag示例</h3>
{% load s1 %}
<p>{% se 2 4 %}</p>
結(jié)果:
inclusion_tag
多用于返回html代碼片段
示例：
templatetags/my_inclusion.py
from django import template
register = template.Library()
@register.inclusion_tag('result.html')
def show_results(n):
n = 1 if n < 1 else int(n)
data = ["第{}項(xiàng)".format(i) for i in range(1, n+1)]
return {"data": data}
templates/snippets/result.html
<ul>
{% for choice in data %}
<li>{{ choice }}</li>
{% endfor %}
</ul>
templates/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="x-ua-compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>inclusion_tag test</title>
</head>
<body>
{% load inclusion_tag_test %}
{% show_results 10 %}
</body>
</html>
母版
什么情況下用母版?
當(dāng)多個(gè)頁(yè)面的大部分內(nèi)容都一樣的時(shí)候，我們可以把相同的部分提取出來(lái)，放到一個(gè)單獨(dú)的母版文件中
使用
- 在母版中定義需要被替換的block
{% block page-main %}
{% endblock %}
- 在子頁(yè)面中
- 先繼承母版 --> {% extends '母版.html' %}
- 定義block
{% block page-main %}
...
{% endblock page-main %}
- 通常的用法
1. {% bloack page-css %} {% endblock %}
2. {% block page-js %} {% endblock %}
母版結(jié)構(gòu)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="x-ua-compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Title</title>
{% block page-css %}
{% endblock %}
</head>
<body>
<h1>這是母板的標(biāo)題</h1>
{% block page-main %}
{% endblock %}
<h1>母板底部?jī)?nèi)容</h1>
{% block page-js %}
{% endblock %}
</body>
</html>
注意：
我們通常會(huì)在母板中定義頁(yè)面專(zhuān)用的CSS塊和JS塊，方便子頁(yè)面替換。
組件
- 什么時(shí)候用組件？
頁(yè)面上相對(duì)獨(dú)立的某個(gè)部分可以單獨(dú)拿出來(lái)放到一個(gè)單獨(dú)的html文件中
- 如何使用？
{% inclued '組件.html' %}
