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