Django模板語言
ofollow,noindex"> 官方文件
常用的語法
在DjangoHong Kong只需要記兩種特殊符號:
{{ }}
{% %}
變數
在Django模板語言中使用:{{變數名}}.
當模板引擎遇到一個變數它將計算這個變數，然後用結果替換掉它本身。 變數的命名包括任何字母數字以及下劃線 ("_")的組合。 變數名稱中不能有空格或標點符號。
點（.）在模板語言中有特殊的含義。當模版系統遇到點(".")，它將以這樣的順序查詢
字典查詢（Dictionary lookup）
屬性或方法查詢（Attribute or method lookup）
數字索引查詢（Numeric index lookup）
注意
1.如果計算結果的值是可呼叫的，它將被無引數的呼叫。 呼叫的結果將成為模版的值。
-
如果使用的變數不存在， 模版系統將插入 string_if_invalid 選項的值， 它被預設設定為'' (空字串) 。
例子
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})
<!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和方法重名優先顯示屬性或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>支援鏈式操作</h3>
<p>{{ list2.1.name }}</p>
<p>{{ list2.1.age }}</p>
</body>
</html>
結果:
頁面顯示結果.png
Filters(過濾器)
在Django的模板語言中，通過使用 過濾器 來改變變數的顯示。
語法:{{ value|filter_name:引數 }}
引數
-
value是變數名 -
|是管道符 -
filter_name:引數是過濾器名和引數例:{{ name|lower }}會將name變數應用lower過濾器之後再顯示它的值。lower在這裡的作用是將文字全都變成小寫。
注意
1.過濾器支援“鏈式”操作。即一個過濾器的輸出作為另一個過濾器的輸入。
2.過濾器可以接受引數，例如： {{ sss|truncatewords:30 }} ，這將顯示sss的前30個詞。
{{ list|join:', ' }}
4.'|'左右沒有空格沒有空格沒有空格
常用的內建過濾器
我們先在 view.py 檔案裡邊寫好要傳的內容:
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 = ''' 只有經歷過地獄般的磨礪，才能練就創造天堂的力量； 只有流過血的手指，才能彈出世間的絕響。 只有經歷過地獄般的磨礪，才能練就創造天堂的力量； 只有流過血的手指，才能彈出世間的絕響。 縱然傷心，也不要愁眉不展，因為你不知是誰會愛上你的笑容。 ''' 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:"預設值"}}
HTML.png
結果:
頁面顯示.png
length
返回值的長度，作用於字串和列表。
{{ value|length} }
HTML.png
結果:
頁面顯示.png
filesizeformat
將值格式化為一個 “人類可讀的” 檔案尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等）。例如：
{{ value|filesizeformat }}
HTML.png
結果:
網頁顯示.png
slice
切片
{{value|slice:"2:-1"}}
HTML.png
結果:
網頁顯示.png
data
時間格式化
{{ value|date:"Y-m-d H:i:s"}}
可用的引數:
| 格式化字元 | 描述 | 示例輸出 |
|---|---|---|
| a | 'a.m.' 或 'p.m.' （請注意，這與PHP的輸出略有不同，因為這包括符合Associated Press風格的期間） |
'a.m.' |
| A | 'AM' 或 'PM' 。 |
'AM' |
| b | 月，文字，3個字母，小寫。 | 'jan' |
| B | 未實現。 | |
| c | ISO 8601格式。 （注意：與其他格式化程式不同，例如“Z”，“O”或“r”，如果值為naive datetime，則“c”格式化程式不會新增時區偏移量（請參閱 datetime.tzinfo ） 。 |
2008-01-02T10:30:00.000123+02:00 或 2008-01-02T10:30:00.000123 如果datetime是天真的 |
| d | 月的日子，帶前導零的2位數字。 | '01' 到 '31' |
| D | 一週中的文字，3個字母。 | “星期五” |
| e | 時區名稱 可能是任何格式，或者可能返回一個空字串，具體取決於datetime。 | '' 、 'GMT' 、 '-500' 、 'US/Eastern' 等 |
| E | 月份，特定地區的替代表示通常用於長日期表示。 | 'listopada' （對於波蘭語區域，而不是 'Listopad' ） |
| f | 時間，在12小時的小時和分鐘內，如果它們為零，則分鐘停留。 專有擴充套件。 | '1' ， '1:30' |
| F | 月，文，長。 | '一月' |
| g | 小時，12小時格式，無前導零。 | '1' 到 '12' |
| G | 小時，24小時格式，無前導零。 | '0' 到 '23' |
| h | 小時，12小時格式。 | '01' 到 '12' |
| H | 小時，24小時格式。 | '00' 到 '23' |
| i | 分鐘。 | '00' 到 '59' |
| I | 夏令時間，無論是否生效。 | '1' 或 '0' |
| j | 沒有前導零的月份的日子。 | '1' 到 '31' |
| l | 星期幾，文字長。 | '星期五' |
| L | 布林值是否是一個閏年。 | True 或 False |
| m | 月，2位數字帶前導零。 | '01' 到 '12' |
| M | 月，文字，3個字母。 | “揚” |
| n | 月無前導零。 | '1' 到 '12' |
| N | 美聯社風格的月份縮寫。 專有擴充套件。 | 'Jan.' ， 'Feb.' ， 'March' ， 'May' |
| o | ISO-8601周編號，對應於使用閏年的ISO-8601週數（W）。 對於更常見的年份格式，請參見Y。 | '1999年' |
| O | 與格林威治時間的差異在幾小時內。 | '+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 | 秒，帶前導零的2位數字。 | '00' 到 '59' |
| S | 一個月的英文序數字尾，2個字元。 | 'st' ， 'nd' ， 'rd' 或 'th' |
| t | 給定月份的天數。 | 28 to 31 |
| T | 本機的時區。 | 'EST' ， 'MDT' |
| u | 微秒。 | 000000 to 999999 |
| U | 自Unix Epoch以來的二分之一（1970年1月1日00:00:00 UTC）。 | |
| w | 星期幾，數字無前導零。 | '0' （星期日）至 '6' （星期六） |
| W | ISO-8601週數，週數從星期一開始。 | 1 ， 53 |
| y | 年份，2位數字。 | '99' |
| Y | 年，4位數。 | '1999年' |
| z | 一年中的日子 | 0 到 365 |
| Z | 時區偏移量，單位為秒。UTC以西時區的偏移量總是為負數，對於UTC以東時，它們總是為正。 | -43200 到 43200 |
HTML.png
結果:
網頁顯示.png
safe
Django的模板中會對HTML標籤和JS等語法標籤進行自動轉義，原因顯而易見，這樣是為了安全。但是有的時候我們可能不希望這些HTML元素被轉義，比如我們做一個內容管理系統，後臺新增的文章中是經過修飾的，這些修飾可能是通過一個類似於FCKeditor編輯加註了HTML修飾符的文字，如果自動轉義的話顯示的就是保護HTML標籤的原始檔。為了在Django中關閉HTML的自動轉義有兩種方式，如果是一個單獨的變數我們可以通過過濾器“|safe”的方式告訴Django這段程式碼是安全的不必轉義。
{{ value|safe}}
HTML.png
結果:
網頁顯示.png
truncatechars和truncatewords
如果字串字元多於指定的字元數量，那麼會被截斷。截斷的字串將以可翻譯的省略號序列（“...”）結尾。
引數：截斷的字元數
{{ value|truncatechars:9}}
在一定數量的字後截斷字串。
{{ value|truncatewords:9}}
HTML.png
結果:
HTML.png
cut
移除value中所有的與給出的變數相同的字串
{{ value|cut:' ' }}
HTML.png
結果:
網頁顯示.png
join
使用字串連線列表，例如Python的str.join(list)
HTML.png
結果:
網頁顯示.png
timesince
將日期格式設為自該日期起的時間（例如，“4天，6小時”）。
採用一個可選引數，它是一個包含用作比較點的日期的變數（不帶引數，比較點為現在）。 例如，如果blog_date是表示2006年6月1日午夜的日期例項，並且comment_date是2006年6月1日08:00的日期例項，則以下將返回“8小時”：
{{ blog_date|timesince:comment_date }}
分鐘是所使用的最小單位，對於相對於比較點的未來的任何日期，將返回“0分鐘”。
HTML.png
結果:
網頁顯示.png
自定義filter
自定義過濾器只是帶有一個或兩個引數的Python函式:
- 變數（輸入）的值 - -不一定是一個字串
- 引數的值 - 這可以有一個預設值，或完全省略
自定義步驟
-
在app下面新建一個python package名字叫templatetags
建立templatetags包
-
在上一步的python package中新建一個py檔案
建立py檔案
-
在py檔案中寫一個函式，實現自定義的filter功能
def sb(value): return value + 'sb'
- 告訴Django我現在多了一個自定義的filter
from django import template register = template.Library() @register.filter() def sb(value): return value + 'sb'
使用步驟
-
在HTML檔案中匯入剛才建立的py檔案
匯入檔案
{% load s1 %}
- 重啟Django專案
- 按照普通的filter呼叫自定義的函式
Tags
for迴圈
普通for迴圈
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% endfor %}
</ul>
for迴圈可用的一些引數：
| Variable | Description |
|---|---|
| forloop.counter | 當前迴圈的索引值（從1開始） |
| forloop.counter0 | 當前迴圈的索引值（從0開始） |
| forloop.revcounter | 當前迴圈的倒序索引值（從1開始） |
| forloop.revcounter0 | 當前迴圈的倒序索引值（從0開始） |
| forloop.first | 當前迴圈是不是第一次迴圈（布林值） |
| forloop.last | 當前迴圈是不是最後一次迴圈（布林值） |
| forloop.parentloop | 本層迴圈的外層迴圈 |
for ... empty
<ul>
{% for user in user_list %}
<li>{{ user.name }}</li>
{% empty %}
<li>空空如也</li>
{% endfor %}
</ul>
if判斷
if,elif和else
{% if user_list %}
使用者人數：{{ user_list|length }}
{% elif black_list %}
黑名單數：{{ black_list|length }}
{% else %}
沒有使用者
{% endif %}
當然也可以只有if和else
{% if user_list|length > 5 %}
七座豪華SUV
{% else %}
黃包車
{% endif %}
if語句支援 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判斷.
with
定義一箇中間變數，多用於給一個複雜的變數起別名。
注意等號左右不要加空格。
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
或
{% with business.employees.count as total %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
csrf_token
這個標籤用於跨站請求偽造保護。
在頁面的form表單裡面寫上 {% csrf_token %}
註釋
{# ... #}
注意事項
- Django的模板語言不支援連續判斷，即不支援以下寫法：
{% if a > b > c %}
...
{% endif %}
- Django的模板語言中屬性的優先順序大於方法
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的值
母版
什麼情況下用母版?
當多個頁面的大部分內容都一樣的時候，我們可以把相同的部分提取出來，放到一個單獨的母版檔案中
使用
- 在母版中定義需要被替換的block
{% block page-main %}
{% endblock %}
- 在子頁面中
- 先繼承母版 --> {% extends '母版.html' %}
- 定義block
{% block page-main %}
...
{% endblock page-main %}
-
通常的用法
1. {% bloack page-css %} {% endblock %}
2. {% block page-js %} {% endblock %}
母版結構
<!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>這是母板的標題</h1>
{% block page-main %}
{% endblock %}
<h1>母板底部內容</h1>
{% block page-js %}
{% endblock %}
</body>
</html>
注意：
我們通常會在母板中定義頁面專用的CSS塊和JS塊，方便子頁面替換。
元件
- 什麼時候用元件？
頁面上相對獨立的某個部分可以單獨拿出來放到一個單獨的html檔案中
-
如何使用？
{% inclue '元件.html' %}