django的模板=HTML代碼+模板語法
存放於templates目錄下的html文件稱之爲模板文件,如果我們想要返回的html頁面中的數據是動態的,那麼必須在html頁面中嵌入變量,這便用到了django的模板語法,具體來說,django的模板語法有以下重點
{{ }} 變量相關
{% %} 邏輯相關
模板語法之變量
基本使用
如果html代碼中的數據不是固定死的,而是動態變化的,則必須在html中嵌入變量,爲此,模板語法提供了變量的概念,允許我們在html代碼中嵌入變量,我們只需要在視圖函數中用render方法爲html文件中指定的變量賦值即可,具體用法如下
- test.html
<body>
<p>{{ msg }}</p>
<p>{{ dic }}</p>
<p>{{ obj }}</p>
<p>{{ li }}</p>
</body>
我們需要在視圖函數中爲模板test.html的變量名msg、li、dic、obj、obj_li賦值
- views.py
from django.shortcuts import render
def test(request):
# 傳給模板的變量值可以是任意python類型,如下
msg='hello world'
dic={'k1':1,'k2':2}
class Person(object):
def __init__(self,name,age):
self.name=name
self.age=age
obj=Person('xxx',18)
li = [1,'aaa',obj]
return render(request,'test.html',{'msg':msg,'dic':dic,'obj':obj,'li':li})
# 注意:
# 1、render函數的第三個參數包含了要傳給模板的變量值,是一個字典類型,該字典中的key必須與模板文件中的變量名相對應,render函數會去templates目錄下找到模板文件,然後根據字典中的key對應到模板文件中的變量名進行賦值操作,最後將賦值後的模板文件內容返回給瀏覽器
# 2、可以將render函數的第三個參數簡寫爲locals(),如下
return render(request,'test.html',locals())
#locals()會將函數test內定義的名字與值轉換爲字典中的k與v
注意:
1.通過字典的鍵值對指名道姓的一個個傳
return render(request, 'reg.html', {'n':n, 'f':f, ...})
2.locals() 會將它所在的名稱空間中的所有名字都傳遞給指定模板
return render(request, 'reg.html', locals()) # 缺點:易造成資源浪費
1.容器數據類型:前端獲取後端傳過來的容器類型的內部元素,統一採用句點符(.)
2.函數:後端傳函數名到前端,會自動加括號調用,但是不支持傳參
3.類:後端傳對象到前端,就相當於打印了這個對象,該對象可以通過點方法拿到類中方法的返回值(類名也一樣)
深度查詢之句點符的使用
當視圖函數傳給模板的值中包含多個元素時,若想取出其中的單個元素,就必須使用句點符了。
句點符既可以引用容器類型的元素,也可以引用對象的方法
- test.html
<body>
<!--調用字符串對象的upper方法,注意不要加括號-->
<p>{{ msg.upper }}</p>
<!--取字典中k1對應的值-->
<p>{{ dic.k1 }}</p>
<!--取對象的name屬性-->
<p>{{ obj.name }}</p>
<!--取列表的第2個元素,然後變成大寫-->
<p>{{ li.1.upper }}</p>
<!--取列表的第3個元素,並取該元素的age屬性-->
<p>{{ li.2.age }}</p>
</body>
過濾器
過濾器類似於python的內置函數,用來把視圖傳入的變量值加以修飾後再顯示,具體語法如下
{{ 變量名|過濾器名:傳給過濾器的參數 }}
原理:會將 | 前面的當做第一個參數傳入標籤中
常用內置過濾器
- default
作用:如果一個變量值是False或者爲空,使用default後指定的默認值,否則,使用變量本身的值,如果value=’‘則輸出“nothing”
{{ value|default:"nothing" }}
- length
作用:返回值的長度。它對字符串、列表、字典等容器類型都起作用,如果value是 ['a', 'b', 'c', 'd'],那麼輸出是4
{{ value|length }}
- filesizeformat
作用:將值的格式化爲一個"人類可讀的"文件尺寸(如13KB、4.1 MB、102bytes等等),如果 value 是 12312312321,輸出將會是 11.5 GB
{{ value|filesizeformat }}
- date
作用:將日期按照指定的格式輸出,如果value=datetime.datetime.now(),按照格式Y-m-d則輸出2019-02-02
{{ value|date:"Y-m-d" }}
- slice
作用:對輸出的字符串進行切片操作,顧頭不顧尾,如果value=“xionger“,則輸出"xi"
{{ value|slice:"0:2" }}
- truncatechars
作用:如果字符串字符多於指定的字符數量,那麼會被截斷。截斷的字符串將以可翻譯的省略號序列(“...”)結尾,如果value=”hello world xionger 嘎嘎“,則輸出"hello...",注意8個字符也包含末尾的3個點
{{ value|truncatechars:8 }}
- truncatewords
作用:同truncatechars,但truncatewords是按照單詞截斷,注意末尾的3個點不算作單詞,如果value=”hello world egon 嘎嘎“,則輸出"hello world ..."
{{ value|truncatewords:2 }}
- safe
作用:出於安全考慮,Django的模板會對HTML標籤、JS等語法標籤進行自動轉義,例如value="<script>alert(123)</script>",模板變量{{ value }}會被渲染成<script>alert(123)</script>交給瀏覽器後會被解析成普通字符”<script>alert(123)</script>“,失去了js代碼的語法意義,但如果我們就想讓模板變量{{ value }}被渲染的結果又語法意義,那麼就用到了過濾器safe,比如value='<a href="https://www.baidu.com">點我啊</a>',在被safe過濾器處理後就成爲了真正的超鏈接,不加safe過濾器則會當做普通字符顯示’<a href="https://www.baidu.com">點我啊</a>‘
{{ value|safe }}
其他過濾器:
過濾器 | 描述 | 示例 |
---|---|---|
upper | 以大寫方式輸出 | {{ user.name | upper }} |
add | 給value加上一個數值 | {{ user.age | add:”5” }} |
addslashes | 單引號加上轉義號 | |
capfirst | 第一個字母大寫 | {{ ‘good’| capfirst }} 返回”Good” |
center | 輸出指定長度的字符串,把變量居中 | {{ “abcd”| center:”50” }} |
cut | 刪除指定字符串 | {{ “You are not a Englishman” | cut:”not” }} |
date | 格式化日期 | |
default | 如果值不存在,則使用默認值代替 | {{ value | default:”(N/A)” }} |
default_if_none | 如果值爲None, 則使用默認值代替 | |
dictsort | 按某字段排序,變量必須是一個dictionary | {% for moment in moments | dictsort:”id” %} |
dictsortreversed | 按某字段倒序排序,變量必須是dictionary | |
divisibleby | 判斷是否可以被數字整除 | {{ 224 | divisibleby:2 }} 返回 True |
escape | 按HTML轉義,比如將”<”轉換爲”<” | |
filesizeformat | 增加數字的可讀性,轉換結果爲13KB,89MB,3Bytes等 | {{ 1024 | filesizeformat }} 返回 1.0KB |
first | 返回列表的第1個元素,變量必須是一個列表 | |
floatformat | 轉換爲指定精度的小數,默認保留1位小數 | {{ 3.1415926 | floatformat:3 }} 返回 3.142 四捨五入 |
get_digit | 從個位數開始截取指定位置的數字 | {{ 123456 | get_digit:’1’}} |
join | 用指定分隔符連接列表 | {{ [‘abc’,’45’] | join:’’ }} 返回 abc45 |
length | 返回列表中元素的個數或字符串長度 | |
length_is | 檢查列表,字符串長度是否符合指定的值 | {{ ‘hello’| length_is:’3’ }} |
linebreaks | 用
或 |
{{ “Hi\n\nDavid”|linebreaks }} 返回
Hi David |
linebreaksbr | 用 標籤代替換行符 |
|
linenumbers | 爲變量中的每一行加上行號 | |
ljust | 輸出指定長度的字符串,變量左對齊 | {{‘ab’|ljust:5}}返回 ‘ab ’ |
lower | 字符串變小寫 | |
make_list | 將字符串轉換爲列表 | |
pluralize | 根據數字確定是否輸出英文複數符號 | |
random | 返回列表的隨機一項 | |
removetags | 刪除字符串中指定的HTML標記 | {{value | removetags: “h1 h2”}} |
rjust | 輸出指定長度的字符串,變量右對齊 | |
slice | 切片操作, 返回列表 | {{[3,9,1] | slice:’:2’}} 返回 [3,9] {{ 'asdikfjhihgie' | slice:':5' }} 返回 ‘asdik’ |
slugify | 在字符串中留下減號和下劃線,其它符號刪除,空格用減號替換 | {{ '5-2=3and5 2=3' | slugify }} 返回 5-23and5-23 |
stringformat | 字符串格式化,語法同python | |
time | 返回日期的時間部分 | |
timesince | 以“到現在爲止過了多長時間”顯示時間變量 | 結果可能爲 45days, 3 hours |
timeuntil | 以“從現在開始到時間變量”還有多長時間顯示時間變量 | |
title | 每個單詞首字母大寫 | |
truncatewords | 將字符串轉換爲省略表達方式 | {{ 'This is a pen' | truncatewords:2 }}返回``This is ... |
truncatewords_html | 同上,但保留其中的HTML標籤 | {{ '<p>This is a pen</p>' | truncatewords:2 }}返回``<p>This is ...</p> |
urlencode | 將字符串中的特殊字符轉換爲url兼容表達方式 | {{ ‘http://www.aaa.com/foo?a=b&b=c’ | urlencode}} |
urlize | 將變量字符串中的url由純文本變爲鏈接 | |
wordcount | 返回變量字符串中的單詞數 | |
yesno | 將布爾變量轉換爲字符串yes, no 或maybe | {{ True | yesno |
模板語法之標籤
標籤是爲了在模板中完成一些特殊功能,語法爲{% 標籤名 %},一些標籤還需要搭配結束標籤 {% endtag %}
for 循環
{% for foo in l %}
<p>{{ foo }}</p>
<p>{{ forloop }}</p>
{% endfor %}
-
empty
當你的for循環對象爲空的時候會自動走empty代碼塊兒的內容
{% for foo in l %}
<p>{{ foo }}</p>
{% empty %}
<p>你給我的容器類型是個空啊,沒法for循環</p>
{% endfor %}
案例:
- url.py
urlpatterns = [
re_path(r'^test/',views.test)
]
- view.py
def test(request):
names=['xxx','yyy']
dic={'name':'xxx','age':18,'sex':'male'}
list1=[]
return render(request,'test.html',locals())
- test.html
<body>
<hr>
{% for name in names %}
<p>{{ forloop.counter0 }} {{ name }}</p>
{% endfor %}
<!--
輸出結果爲:
0 xxx
1 yyy
-->
<hr>
{% for name in names reversed %}
<p>{{ forloop.revcounter0 }} {{ name }}</p>
{% endfor %}
<!--
輸出結果爲:
1 yyy
0 xxx
-->
<hr>
{% for k,v in dic.items %}
<p>{{ forloop.counter }} {{ k }} {{ v }}</p>
{% endfor %}
<!--
輸出結果爲:
1 name xxx
2 age 18
3 sex male
-->
<hr>
{% for item in list1 %}
<p>{{ item }}</p>
{% empty %}
<p>sorry,no value here</p>
{% endfor %}
<!--
輸出結果爲:
sorry,no value here
-->
</body>
if 判斷
{% if 條件 %}條件爲真時if的子句纔會生效,條件也可以是一個變量,if會對變量進行求值,在變量值爲空、或者視圖沒有爲其傳值的情況下均爲False
{% if num > 100 or num < 0 %}
<p>無效</p>
{% elif num > 80 and num < 100 %}
<p>優秀</p>
{% else %}
<p>湊活吧</p>
{% endif %}
if語句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判斷。
案例:
- urls.py
urlpatterns = [
# 輸入http://127.0.0.1:8008/或者http://127.0.0.1:8008/index/都會轉發給視圖函數index
re_path(r'^$',views.index),
re_path(r'^index/$',views.index),
re_path(r'^login/',views.login),
]
- views.py
from django.shortcuts import render
def index(request):
return render(request,'index.html')
def login(request):
if request.method == 'GET':
return render(request,'login.html')
name=request.POST.get('name')
pwd=request.POST.get('pwd')
if name == 'egon' and pwd == '123':
current_user=name
return render(request,'index.html',locals())
else:
msg='賬號或密碼錯誤'
return render(request,'login.html',locals())
- index.html
<body>
<h3>首頁</h3>
<!--
如果用戶已經登錄,則current_user變量有值,if判斷結果爲真,會打印變量current_user的值,爲當前登錄的用戶名
如果用戶沒有登錄,則current_user變量無值,if判斷結果爲假,會打印a標籤要求用戶先登錄
-->
{% if current_user %}
<p>當前登錄用戶爲:{{ current_user }}</p>
{% else %}
<p><a href="/login/">請先登錄</a></p>
{% endif %}
</body>
- login.html
<body>
<form action="" method="POST">
{% csrf_token %}
<p>用戶名:<input type="text" name="name"></p>
<p>密碼:<input type="password" name="pwd"></p>
<p><input type="submit" value="提交"></p>
</form>
<!--輸錯賬號密碼時的提示信息-->
<p style="color: red">{{ msg }}</p>
</body>
with標籤
with標籤用來爲一個複雜的變量名起別名,如果變量的值來自於數據庫,在起別名後只需要使用別名即可,無需每次都向數據庫發送請求來重新獲取變量的值
{% with li.1.upper as v %}
{{ v }}
{% endwith %}
csrf_token標籤
當用form表單提交POST請求時必須加上標籤{% csrf_token%},該標籤用於防止跨站僞造請求
<form action="" method="POST">
{% csrf_token %}
<p>用戶名:<input type="text" name="name"></p>
<p>密碼:<input type="password" name="pwd"></p>
<p><input type="submit" value="提交"></p>
</form>
具體工作原理爲:
1、在GET請求到form表單時,標籤{% csrf_token%}會被渲染成一個隱藏的input標籤,該標籤包含了由服務端生成的一串隨機字符串,如<input type="hidden" name="csrfmiddlewaretoken" value="dmje28mFo...OvnZ5">
2、在使用form表單提交POST請求時,會提交上述隨機字符串,服務端在接收到該POST請求時會對比該隨機字符串,對比成功則處理該POST請求,否則拒絕,以此來確定客戶
自定義過濾器和標籤
# 自定義必需要做的三件事
1.在應用名下新建一個名爲templatetags文件夾(必須叫這個名字)
2.在該新建的文件夾內新建一個任意名稱的py文件
3.在該py文件中需要固定寫下面兩句代碼:
from django import template
register = template.Library()
注意: 必須先在需要使用的html頁面加載你的py文件 {% load mytag %}
自定義過濾器或標籤必須重新啓動django方可生效
案例:
- mytag.py
from django import template
register = template.Library() # 注意變量名必須爲register,不可改變
#1、自定義過濾器
@register.filter
def my_multi_filter(v1 ,v2): # 自定義的過濾器只能定義最多兩個參數,針對{{ value1 | filter_multi:value2 }},參數傳遞爲v1=value1,v2=value2
return v1 * v2
#2、自定義標籤
@register.simple_tag
def my_multi_tag(v1, v2): # 自定義的標籤可以定義多個參數
return v1 * v2
#3、自定義標籤擴展之mark_safe
# 註釋:我們可以用內置的標籤safe來讓標籤內容有語法意義,如果我們想讓自定義標籤處理的結果也有語法意義,則不能使用內置標籤safe了,需要使用mark_safe,可以實現與內置標籤safe同樣的功能
from django.utils.safestring import mark_safe
@register.simple_tag
def my_input_tag(id, name):
res = "<input type='text' id='%s' name='%s' />" % (id, name)
return mark_safe(res)
- test.html
<body>
<!--必須先加載存有自定義過濾器和標籤的文件-->
{% load mytag %}
<!--salary的值爲10,經過濾器my_multi_filter的處理結果爲120-->
{{ salary|my_multi_filter:12 }}
<!--結果爲2-->
{% my_multi_tag 1 2 %}
<!--
結果爲一個input標籤,該表的屬性id="inp1" name="username"
注意:input的屬性值均爲字符串類型,所以my_input_tag後的兩個值均爲字符串類型
-->
{% my_input_tag "inp1" "username" %}
</body>
對比自定義標籤與自定義過濾器
#1、自定義過濾器只能傳兩個參數,而自定義標籤卻可以傳多個參數
#2、過濾器可以用於if判斷,而標籤不能
{% if salary|my_multi_filter:12 > 200 %}
<p>優秀</p>
{% else %}
<p>垃圾</p>
{% endif %}
模板的導入和繼承
在實際開發中,模板文件彼此之間可能會有大量冗餘代碼,爲此django提供了專門的語法來解決這個問題,主要圍繞三種標籤的使用:include標籤、extends標籤、block標籤,詳解如下
模板導入 include
作用:在一個模板文件中,引入/重用另外一個模板文件的內容
如: 當你寫了一個特別好看的form表單/列表標籤等,可以將它當成一個模塊,哪個地方需要,就直接導入使用即可
{% include '模版名稱' %}
使用
<!--將一段html當做模塊的方式導入到另一個html展示-->
{% include 'beautiful.html' %}
模板繼承 extends / block
當多個頁面整體的樣式都大差不差的情況下,可以設置一個模板文件,在該模板文件中,使用block塊劃分多個預期,
之後子版在使用模板的時候,可以通過block塊的名字,來選定到底需要修改哪一部分區域
使用:
<!--第一步: 首先需要在被繼承的模板中劃分多個區域-->
{% block 給區域起的名字 %}
區域代碼塊
{% endblock %}
<!--第二步:繼承模板所有的內容-->
{% extends 'home.html' %}
<!--第三步:根據block塊的名字修改指定區域的內容-->
{% block content %}
<h1>登錄頁面</h1>
<form action="">
<p>username:<input type="text" class="form-control"></p>
<p>password:<input type="text" class="form-control"></p>
<input type="submit" class="btn btn-success">
</form>
{% endblock %}
<!--ps:通常情況下一個模板中應該至少有三塊,一般情況下,模板上的block越多,頁面的可擴展性就越強-->
{% block css %}
頁面css代碼塊
{% endblock %}
{% block content %}
頁面主體內容
{% endblock %}
{% block js %}
頁面js代碼塊
{% endblock %}