對于模板引擎，比較有名的有DTL和Jinja2等，Django使用的則是DTL（Django Template Language），雖然也可以配置Django專案使用別的模板引擎，但是推薦使用Django自帶的DTL，DTL模板是一種含有特殊語法的HTML檔案，在Django中，這種檔案會先被DTL模板引擎預編譯為一個普通的HTML檔案，然后再發送到客戶端，
一、render傳參（模板變數）
使用render回傳HTML模板時，給render的引數context指定一個字典，字典的key對應HTML模板中使用的變數，key對應的value則是該變數的值，在HTML模板中使用語法{{ key }}即可，如果key對應的value是一個物件，也可以使用{{ key.attr_name }}的形式獲取物件的屬性等資訊，
"""視圖函式"""
from django.shortcuts import render
def index(request):
context = {
'username': 'Hello world!'
}
# 給render的context引數指定一個字典并將其傳入到HTML模板中
return render(request, 'index.html', context=context)
<body>
{{ username }}
</body>
其他用法：
- 物件嵌套：例如字典中的value也是一個字典，想要獲取這個嵌套字典中的value，直接使用點號即可
{{ key.sub_key }}， - 獲取串列中的某個元素：使用形如
{{ list.0 }}表示獲取串列的第0個元素，想要獲取其他的元素，也是類似的用法，
二、模板標簽
模板標簽就相當于在HTML模板中使用的“Python代碼”，但是需要注意，所有的標簽語法都需要包裹在{% %}中，并且大多標簽都有其對應的閉合標簽，閉合標簽通常是“end+標簽名”的形式，如if的閉合標簽為endif，
if標簽
相當于Python中的if陳述句，有對應的elif和else陳述句，同樣也可以使用==, !=, <, <=, >, >=, in, not, is, is not等判斷運算子，對應的閉合標簽為endif，
{% if age < 18 %}
<p>未成年</p>
{% elif age == 18 %}
<p>剛成年</p>
{% else %}
<p>已成年</p>
{% endif %}
for標簽
相當于Python中的for陳述句，基本結構為for...in...empty，如果遍歷的物件中沒有值，則會執行empty標簽中的內容，對應的閉合標簽為endfor，
注：DTL模板語法中的for標簽是沒有continue和break陳述句的，
示例：正序遍歷
<ul>
{% for book in books %}
<li>{{ book }}</li>
{% empty %}
<li>沒有書籍！</li>
{% endfor %}
</ul>
示例：反序遍歷（在遍歷的物件后面添加一個reversed關鍵字）
<ul>
{% for book in books reversed %}
<li>{{ book }}</li>
{% endfor %}
</ul>
示例：遍歷字典，可以使用字典對應的keys、values和items等方法，但是注意方法名后面沒有Python中表示執行的括號，
{% for key, value in person.items %}
<p>key: {{ key }}</p>
<p>value: {{ value }}</p>
{% endfor %}
在for回圈中，DTL提供了一個forloop變數來查詢此for回圈的一些資訊：
forloop.counter：當前回圈的下標，以1開始，forloop.counter0：當前回圈的下標，以0開始，forloop.revcounter：forloop.counter的反向下標，forloop.revcounter0：forloop.counter0的反向下標，forloop.first：是否是第一次遍歷，forloop.last：是否是最后一次遍歷，forloop.parentloop：如果有多重for回圈，那么這個屬性代表當前回圈的上一個回圈，
with標簽
with標簽是用來在HTML模板中定義變數的，形如{% with var_name=value %}...{% endwith %}或者{% with value as var_name %}...{% endwith %}，注意，如果使用等號=的方式，那么等號=兩邊不能有空格，對應的閉合標簽為endwith，
注：with中定義的變數只能在對應的with陳述句塊中使用，
"""視圖函式"""
from django.shortcuts import render
def index(request):
context = {
'persons': ['張三', '李四']
}
return render(request, 'index.html', context=context)
{% with person.1 as lisi %}
<p>{{ lisi }}</p>
{% endwith %}
url標簽
url標簽的作用就相當于from django.shortcuts import reverse ，用于通過URL名稱反轉為對應的URL，區別在于，reverse用在Python檔案中，url標簽則用在HTML模板檔案中，
示例：普通用法，使用{% url 'url_name' %}的方式，
urlpatterns = [
path('book/', views.book, name='book')
]
<ul>
<li><a href="https://www.cnblogs.com/">首頁</a></li>
<li><a href="https://www.cnblogs.com/guyuyun/archive/2020/10/11/{% url'book' %}">讀書</a></li>
</ul>
示例：通過url標簽傳參，在url標簽陳述句后面添加需要的引數即可，多個引數之間使用空格分隔，
<li><a href="https://www.cnblogs.com/guyuyun/archive/2020/10/11/{% url'book' book_id='1' %}">讀書</a></li>
示例：通過url標簽傳入查詢字串，和reversed的使用類似，需要手工拼接查詢字串，
<li><a href="https://www.cnblogs.com/guyuyun/archive/2020/10/11/{% url'book' %}?book_id=1">讀書</a></li>
spaceless標簽
此標簽會移除HTML標簽之間的空白字符，包括空格、tab鍵、換行等，閉合標簽為endspaceless，
注：此標簽不會移除HTML標簽內本身的內容，
以下代碼：
{% spaceless %}
<p>
<a href="https://www.cnblogs.com/guyuyun/archive/2020/10/11/foo/"> Foo </a>
</p>
{% endspaceless %}
渲染完成后，變為：
<p><a href="https://www.cnblogs.com/guyuyun/archive/2020/10/11/foo/"> Foo </a></p>
autoescape標簽
此標簽表示自動轉義功能，默認是開啟的(on)，表示將HTML中的特殊字符轉義為HTML語法中的字符表示，如將<轉義為<等，這意味著，字串中的這些字符不會當成HTML語法來進行渲染加載，而是當成了普通字符，如果關閉自動轉義功能（off），則會將字串中的特殊字符當成HTML語法符號來進行渲染加載，閉合標簽為endautoescape，
注：為了安全考慮，一個字串需要確認安全可信任后才能關閉自動轉義，
示例：使用autoescape關閉了自動轉義功能后，加載出來直接就是一個超鏈接了，
context = {
'info': "<a href='https://www.cnblogs.com/guyuyun/archive/2020/10/11/www.baidu.com'>百度</a>"
}
{% autoescape off %}
{{ info }}
{% endautoescape %}
verbatim標簽
在DTL模板中會自動決議{% %}和{{ }}等字符，如果某段代碼你不想DTL去決議，就想它按照原內容輸出，就可以使用verbatim標簽將這部分代碼包裹起來，閉合標簽為endverbatim，
三、模板過濾器
過濾器其實就相當于一個可以接收引數的函式，對傳入模板的某些值進行處理后顯示，對于一個普通函式，如果直接通過render將函式傳入模板中，把它當成一個變數來使用，如果函式沒有引數需要傳遞，則會直接將函式回傳值渲染到模板中，如果這個函式需要引數，則無法這樣使用了，此時可以考慮使用自定義過濾器來實作該函式的功能，
注：過濾器最多只能接收兩個引數，使用形如{{ value|filter_name[:value2] }}，
示例：將無參函式直接傳入模板中
from django.shortcuts import render
def greet():
return 'hello world!'
def index(request):
context = {
'greet': greet
}
return render(request, 'index.html', context=context)
# 直接在模板中這樣寫：{{ greet }}
# 會將greet函式的回傳值添加到模板中
內置模板過濾器
這里列舉一些Django內置的常用過濾器，更多過濾器可以去官網看看，
add：使用形如{{ value|add:arg }}，會嘗試將value和后面的引數先轉換為int型別再相加，如果失敗，則會將兩個引數直接進行+運算（字串拼接和串列拼接），如果再次失敗，則回傳一個空字串，cut：使用形如{{ value|cut:arg }}，移除字串value中指定的子串arg，相當于Python中的value.replace(arg, '')，date：使用形如{{ my_date|date: "Y-m-d" }}，將傳入模板的日期物件如from datetime import datetime;my_date = datetime.now()根據后面的格式字串進行格式化，常用的格式字符如下：格式字符 描述 Y 四位數字的年份 m 月份，如01-12 n 月份，如1-12 d 天，如01-31 j 天，如1-31 h 小時，12小時制，如01-12 g 小時，12小時制，如1-12 H 小時，24小時制，如01-24 G 小時，24小時制，如1-24 i 分鐘，如00-59 s 秒，如00-59 default：使用形如{{ value|default:arg }}，如果value在Python的if判斷中被判斷為False的話，如None、空串列、空字串、空字典等，則使用default指定的值arg，default_if_none：使用形如{{ value|default:arg }}，如果value的值為None則使用default指定的值arg，fist：使用形如{{ value|first }}，回傳串列、元組、字串的第一個元素，last：使用形如{{ value|last }}，回傳串列、元組、字串的最后一個元素，floatformat：使用形如{{ value|floatformat }}或者{{ value|floatformat:num }}，格式化數字value的輸出（四舍五入），引數num表示輸出的小數位數，如果沒有指定num（前者），則默認輸出一位小數，需要注意，默認的情況下（前者），如果數字value的小數部分原本就全為0，則不會輸出對應的小數，只會輸出為整數，join：使用形如{{ value|join:"/" }}，于Python中的join方法類似，將串列或元組或字串使用指定的字符拼接起來，length：使用形如{{ value|length }}，獲取串列、元組、字串、字典等的長度，lower：使用形如{{ value|lower }}，將value中的字母全部轉換為小寫，upper：使用形如{{ value|upper }}，將value中的字母全部轉換為大寫，random：使用形如{{ value|random }}，在給定的串列、元組、字串中隨機選擇一個值，safe：使用形如{{ value|safe }}，表示給定的字串value是安全的，會關閉該字串的自動轉義，相當于{% autoescape off %} {{ value }} {% endautoescape %}，即如果value中包含了html接去執行這部分代碼，slice：使用形如{{ value|slice:"2:" }}，相當于Python中的切片操作，Python中怎么切片，這里就怎么用，比如步長也是支持的，如{{ value|slice:"2::2" }}指定步長為2，striptags：使用形如{{ value|stiptags }}，洗掉字串中的所有HTML標簽，truncatechars：使用形如{{ value|truncatechars:num }}，只顯示字串的前num-3個字串，之所以要減3，是因為num表示要顯示的字串總長度，而最后輸出的字串后面會有三個點...就占了3個字符了，truncatechars_html：使用形如{{ value|truncatechars_html:num }}，功能和truncatechars類似，不同之處在于，truncatechars會切割value中的所有內容，而truncatechars_html會忽略value中的HTML標簽，
自定義模板過濾器
模板過濾器其實就是一個普通的函式，自定義過濾器注意事項和步驟如下：
- 在子app目錄下新建一個
templatetags包，注意，這個包名只能是這個名稱，不能隨便進行自定義，不然Django無法識別， - 在
templatetags包下新建一個Python檔案，檔案名可以自定義，如my_filter.py，然后在檔案中進行過濾器的定義和注冊，函式（過濾器）定義時，第一個引數必須是豎線左側的值value，如果過濾器需要引數，可以定義第二個引數，注意，過濾器最多只能有兩個引數，示例代碼如下：
"""my_filter.py"""
from django import template
register = template.Library()
# 定義過濾器，可以只有一個引數value，也可以定義兩個引數，第二個引數可以設定默認值
# 注冊方式一：以裝飾器的方式進行注冊，過濾器名稱默認和函式名一樣，
# 也可以通過引數指定過濾器名稱
# @register.filter('my_greet')
@register.filter
def greet(value, word=''):
return value+word
# 注冊方式二：以方法的方式進行注冊，可以自定義過濾器名稱
# register.filter('greet', greet)
- 將子app添加到
settings.py中的配置項INSTALLED_APPS， - 在模板中使用自定義過濾器時，需要先在模板開頭添加如
{% load my_filter %}，注意，這里的my_filter為包含過濾器的Python檔案，示例代碼如下：
{% load my_filter %}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
{{ value|greet:" 你好！" }}
</body>
</html>
四、特殊標簽
include標簽
使用形如{% include "xxx.html" [with var=value] %}，相當于是把xxx.html檔案中的內容直接插入到指定位置（這個標簽使用時的位置），with表示定義一個引數，此引數可以在xxx.html檔案中參考，
對于父模板（使用include標簽的模板）中的引數，子模板（xxx.html）可以直接使用，如果父模板中沒有此引數，就需要使用with來定義該引數，不然子模板無法使用父模板中沒有的引數了，
xxx.html的路徑表示也是相對于templates檔案夾的位置，
extends標簽
extends標簽必須寫在HTML代碼的最前面一行，否則會報錯，
使用形如{% extends "xxx.html" %}，可以將xxx.html中所有的內容繼承到當前檔案中，父模板（xxx.html）中使用形如{% block block_name %}...{% endblock %}來定義一個“塊”，子模板（當前模板）如果想要重寫這個block中的內容，直接在子模板中重寫這個block即可，子模板中的相同block名稱的block內容會覆寫父模板中同名的block，如果不想覆寫父模板中此block的內容，又想在此父block中添加一些新內容，可以使用{{ block.super }}參考父模板中此block的所有內容，
如果模板使用了extends標簽，而子模板中的內容沒有寫在block塊中，那么在block之外的代碼就會被忽略（無效代碼），所以子模板中的內容都必須要先在父模板中使用block進行占位，再在子模板中進行重寫，
注：傳入子模板中的變數是可以直接在父模板中使用的，
五、靜態檔案加載
靜態檔案的加載可以使用全路徑名，即相對于專案根目錄的路徑名，但是在DTL模板中也可以使用static標簽，感興趣可以看下，以下是使用方法和注意事項：
- 因為
static標簽并不是Django內置的標簽，所以每次使用時都需要先{% load static %}，為了解決這個問題，可以在settings.py中的TEMPLATES的OPTIONS字典中添加'builtins': ['django.templatetags.static']，這樣static標簽就可以像Django內置標簽一樣直接使用了， - 確保
django.contrib.staticfiles已經被添加到settings.py中的配置項INSTALLED_APPS中了，（默認是已經添加了的） - 確保在
settings.py中配置了STATIC_URL配置項，此配置項用于設定靜態檔案的自動查找路徑，默認為/static/，（默認已經配置了的） - 將對應子app添加到
settings.py中的配置項INSTALLED_APPS中，并在子app目錄下創建static檔案夾， - 使用形如
<img src="https://www.cnblogs.com/guyuyun/archive/2020/10/11/{% static'logo.jpg' %}" alt="">訪問某個靜態檔案，此靜態檔案路徑是相對于子app下的static檔案夾的相對路徑， - 如果需要放置一些整個專案都通用的靜態檔案（通常都需要），也可以在專案根目錄下創建一個
static檔案夾，然后在settings.py檔案中配置STATICFILES_DIRS配置項（串列）中將這個static檔案夾的路徑添加進去即可（可以參考模板templates檔案夾的配置方法），如此的話，Django在各個子app下都查找不到對應的靜態檔案的話，就會在這個目錄下去查找，
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/166998.html
標籤：其他