Django框架模板用法詳解
在上一章節(jié)中我們使用 django.http.HttpResponse() 來輸出 "Hello World!"。該方式將數(shù)據(jù)與視圖混合在一起,不符合 Django 的 MVC 思想。
本章節(jié)我們將為大家詳細介紹 Django 模板的應用,模板是一個文本,用于分離文檔的表現(xiàn)形式和內(nèi)容。
一、模板應用實例
我們接著上一章節(jié)的項目將在 HelloWorld 目錄底下創(chuàng)建 templates 目錄并建立 runoob.html文件,整個目錄結(jié)構(gòu)如下:
HelloWorld/
|-- HelloWorld
| |-- __init__.py
| |-- __init__.pyc
| |-- settings.py
| |-- settings.pyc
| |-- urls.py
| |-- urls.pyc
| |-- views.py
| |-- views.pyc
| |-- wsgi.py
| `-- wsgi.pyc
|-- manage.py
`-- templates
`-- runoob.htmlrunoob.html 文件代碼如下:
<h1>{{ hello }}</h1>從模板中我們知道變量使用了雙括號。
接下來我們需要向Django說明模板文件的路徑,修改HelloWorld/settings.py,修改 TEMPLATES 中的 DIRS 為 [BASE_DIR+"/templates",],如下所示:
...TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [BASE_DIR+"/templates",], # 修改位置
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
...我們現(xiàn)在修改 views.py,增加一個新的對象,用于向模板提交數(shù)據(jù):
from django.shortcuts import render
def runoob(request):
context = {}
context['hello'] = 'Hello World!'
return render(request, 'runoob.html', context)urls.py 文件代碼:
from django.urls import path
from . import views
urlpatterns = [
path('runoob/', views.runoob),
]可以看到,我們這里使用 render 來替代之前使用的 HttpResponse。render 還使用了一個字典 context 作為參數(shù)。
context 字典中元素的鍵值 hello 對應了模板中的變量 {{ hello }}。
再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

這樣我們就完成了使用模板來輸出數(shù)據(jù),從而實現(xiàn)數(shù)據(jù)與視圖分離。
接下來我們將具體介紹模板中常用的語法規(guī)則。
二、Django 模板標簽
1、變量
模板語法:
view:{"HTML變量名" : "views變量名"} HTML:{{變量名}}
from django.shortcuts import render
def runoob(request):
views_name = "菜鳥教程"
return render(request,"runoob.html", {"name":views_name})templates 中的 runoob.html :
<p>{{ name }}</p>
再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

2、列表
templates 中的 runoob.html中,可以用 . 索引下標取出對應的元素。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_list = ["菜鳥教程1","菜鳥教程2","菜鳥教程3"]
return render(request, "runoob.html", {"views_list": views_list})HelloWorld/templates/runoob.html 文件代碼:
<p>{{ views_list }}</p> # 取出整個列表
<p>{{ views_list.0 }}</p> # 取出列表的第一個元素再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

3、字典
templates 中的 runoob.html中,可以用 .鍵 取出對應的值。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_dict = {"name":"菜鳥教程"}
return render(request, "runoob.html", {"views_dict": views_dict})HelloWorld/templates/runoob.html 文件代碼:
<p>{{ views_dict }}</p>
<p>{{ views_dict.name }}</p>再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

4、過濾器
模板語法:
{{ 變量名 | 過濾器:可選參數(shù) }}模板過濾器可以在變量被顯示前修改它,過濾器使用管道字符,如下所示:
{{ name|lower }}{{ name }} 變量被過濾器 lower 處理后,文檔大寫轉(zhuǎn)換文本為小寫。
過濾管道可以被* 套接* ,既是說,一個過濾器管道的輸出又可以作為下一個管道的輸入:
{{ my_list|first|upper }}以上實例將第一個元素并將其轉(zhuǎn)化為大寫。
有些過濾器有參數(shù)。 過濾器的參數(shù)跟隨冒號之后并且總是以雙引號包含。 例如:
{{ bio|truncatewords:"30" }}這個將顯示變量 bio 的前30個詞。
其他過濾器:
- addslashes : 添加反斜杠到任何反斜杠、單引號或者雙引號前面。
- date : 按指定的格式字符串參數(shù)格式化 date 或者 datetime 對象,實例:
{{ pub_date|date:"F j, Y" }}- length : 返回變量的長度。
(1)default
default 為變量提供一個默認值。
如果 views 傳的變量的布爾值是 false,則使用指定的默認值。
以下值為 false:
0 0.0 False 0j "" [] () set() {} NoneHelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
name =0
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代碼:
{{ name|default:"菜鳥教程666" }}再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

(2)length
返回對象的長度,適用于字符串和列表。
字典返回的是鍵值對的數(shù)量,集合返回的是去重后的長度。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
name ="菜鳥教程"
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代碼:
{{ name|length}}再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

(3)filesizeformat
以更易讀的方式顯示文件的大小(即'13 KB', '4.1 MB', '102 bytes'等)。
字典返回的是鍵值對的數(shù)量,集合返回的是去重后的長度。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
num=1024
return render(request, "runoob.html", {"num": num})HelloWorld/templates/runoob.html 文件代碼:
{{ num|filesizeformat}}再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

(4)date
根據(jù)給定格式對一個日期變量進行格式化。
格式 Y-m-d H:i:s返回 年-月-日 小時:分鐘:秒 的格式時間。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
import datetime
now =datetime.datetime.now()
return render(request, "runoob.html", {"time": now})HelloWorld/templates/runoob.html 文件代碼:
{{ time|date:"Y-m-d" }}再次訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

(5)truncatechars
如果字符串包含的字符總個數(shù)多于指定的字符數(shù)量,那么會被截斷掉后面的部分。
截斷的字符串將以 ... 結(jié)尾。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_str = "菜鳥教程"
return render(request, "runoob.html", {"views_str": views_str})HelloWorld/templates/runoob.html 文件代碼:
{{ views_str|truncatechars:2}}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

(6)safe
將字符串標記為安全,不需要轉(zhuǎn)義。
要保證 views.py 傳過來的數(shù)據(jù)絕對安全,才能用 safe。
和后端 views.py 的 mark_safe 效果相同。
Django 會自動對 views.py 傳到HTML文件中的標簽語法進行轉(zhuǎn)義,令其語義失效。加 safe 過濾器是告訴 Django 該數(shù)據(jù)是安全的,不必對其進行轉(zhuǎn)義,可以讓該數(shù)據(jù)語義生效。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_str = "<a
return render(request, "runoob.html", {"views_str": views_str})HelloWorld/templates/runoob.html 文件代碼:
{{ views_str|safe }}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

5、if/else 標簽
基本語法格式如下:
{% if condition %}
... display
{% endif %}或者:
{% if condition1 %}
... display 1
{% elif condition2 %}
... display 2
{% else %}
... display 3
{% endif %}根據(jù)條件判斷是否輸出。if/else 支持嵌套。
{% if %} 標簽接受 and , or 或者 not 關鍵字來對多個變量做判斷 ,或者對變量取反( not ),例如:
{% if athlete_list and coach_list %}
athletes 和 coaches 變量都是可用的。
{% endif %}HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_num = 88
return render(request, "runoob.html", {"num": views_num})HelloWorld/templates/runoob.html 文件代碼:
{%if num > 90 and num <= 100 %}
優(yōu)秀
{% elif num > 60 and num <= 90 %}
合格
{% else %}
一邊玩去~
{% endif %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

6、for 標簽
{% for %} 允許我們在一個序列上迭代。
與 Python 的 for 語句的情形類似,循環(huán)語法是 for X in Y ,Y 是要迭代的序列而 X 是在每一個特定的循環(huán)中使用的變量名稱。
每一次循環(huán)中,模板系統(tǒng)會渲染在 {% for %} 和 {% endfor %} 之間的所有內(nèi)容。
例如,給定一個運動員列表 athlete_list 變量,我們可以使用下面的代碼來顯示這個列表:
<ul>
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% endfor %}
</ul>HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_list = ["菜鳥教程","菜鳥教程1","菜鳥教程2","菜鳥教程3",]
return render(request, "runoob.html", {"views_list": views_list})HelloWorld/templates/runoob.html 文件代碼:
{% for i in views_list %}
{{ i }}
{% endfor %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

給標簽增加一個 reversed 使得該列表被反向迭代:
{% for athlete in athlete_list reversed %}
...
{% endfor %}HelloWorld/templates/runoob.html 文件代碼:
{% for i in views_list reversed%}
{{ i }}
{% endfor %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

遍歷字典: 可以直接用字典 .items 方法,用變量的解包分別獲取鍵和值。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_dict = {"name":"菜鳥教程","age":18}
return render(request, "runoob.html", {"views_dict": views_dict})HelloWorld/templates/runoob.html 文件代碼:
{% for i,j in views_dict.items %}
{{ i }}---{{ j }}
{% endfor %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

在 {% for %} 標簽里可以通過 {{forloop}} 變量獲取循環(huán)序號。
- forloop.counter: 順序獲取循環(huán)序號,從 1 開始計算
- forloop.counter0: 順序獲取循環(huán)序號,從 0 開始計算
- forloop.revcounter: 倒敘獲取循環(huán)序號,結(jié)尾序號為 1
- forloop.revcounter0: 倒敘獲取循環(huán)序號,結(jié)尾序號為 0
- forloop.first(一般配合if標簽使用): 第一條數(shù)據(jù)返回 True,其他數(shù)據(jù)返回 False
- forloop.last(一般配合if標簽使用): 最后一條數(shù)據(jù)返回 True,其他數(shù)據(jù)返回 False
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_list = ["a", "b", "c", "d", "e"]
return render(request, "runoob.html", {"listvar": views_list})HelloWorld/templates/runoob.html 文件代碼:
{% for i in listvar %}
{{ forloop.counter }}
{{ forloop.counter0 }}
{{ forloop.revcounter }}
{{ forloop.revcounter0 }}
{{ forloop.first }}
{{ forloop.last }}
{% endfor %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

{% empty %}
可選的 {% empty %} 從句:在循環(huán)為空的時候執(zhí)行(即 in 后面的參數(shù)布爾值為 False )。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
views_list = []
return render(request, "runoob.html", {"listvar": views_list})HelloWorld/templates/runoob.html 文件代碼:
{% for i in listvar %}
{{ forloop.counter0 }}
{% empty %}
空空如也~
{% endfor %}再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

可以嵌套使用 {% for %} 標簽:
{% for athlete in athlete_list %}
<h1>{{ athlete.name }}</h1>
<ul>
{% for sport in athlete.sports_played %}
<li>{{ sport }}</li>
{% endfor %}
</ul>
{% endfor %}7、ifequal/ifnotequal 標簽
{% ifequal %} 標簽比較兩個值,當他們相等時,顯示在 {% ifequal %} 和 {% endifequal %} 之中所有的值。
下面的例子比較兩個模板變量 user 和 currentuser :
{% ifequal user currentuser %}
<h1>Welcome!</h1>
{% endifequal %}和 {% if %} 類似, {% ifequal %} 支持可選的 {% else%} 標簽:8
{% ifequal section 'sitenews' %}
<h1>Site News</h1>
{% else %}
<h1>No News Here</h1>
{% endifequal %}8、注釋標簽
Django 注釋使用 {# #}。
{# 這是一個注釋 #}9、include 標簽
{% include %} 標簽允許在模板中包含其它的模板的內(nèi)容。
下面這個例子都包含了 nav.html 模板:
{% include "nav.html" %}三、csrf_token
csrf_token 用于form表單中,作用是跨站請求偽造保護。
如果不用{% csrf_token %}標簽,在用 form 表單時,要再次跳轉(zhuǎn)頁面會報403權(quán)限錯誤。
用了{% csrf_token %}標簽,在 form 表單提交數(shù)據(jù)時,才會成功。
解析:
首先,向瀏覽器發(fā)送請求,獲取登錄頁面,此時中間件 csrf 會自動生成一個隱藏input標簽,該標簽里的 value 屬性的值是一個隨機的字符串,用戶獲取到登錄頁面的同時也獲取到了這個隱藏的input標簽。
然后,等用戶需要用到form表單提交數(shù)據(jù)的時候,會攜帶這個 input 標簽一起提交給中間件 csrf,原因是 form 表單提交數(shù)據(jù)時,會包括所有的 input 標簽,中間件 csrf 接收到數(shù)據(jù)時,會判斷,這個隨機字符串是不是第一次它發(fā)給用戶的那個,如果是,則數(shù)據(jù)提交成功,如果不是,則返回403權(quán)限錯誤。
四、自定義標簽和過濾器
1、在 app 目錄下創(chuàng)建 templatetags 目錄(目錄名只能是 templatetags)。
2、在 templatetags 目錄下創(chuàng)建任意 py 文件,如:my_tags.py。
3、在該 py 文件下:
from django import template register = template.Library() #register的名字是固定的,不可改變
4、利用裝飾器 @register.filter 自定義過濾器。
注意:裝飾器的參數(shù)最多只能有 2 個。
@register.filter
def my_filter(v1, v2):
return v1 * v25、利用裝飾器 @register.simple_tag 自定義標簽。
@register.simple_tag
def my_tag1(v1, v2, v3):
return v1 * v2 * v36、在使用自定義標簽和過濾器前,要在 html 文件 body 的最上方中導入該 py 文件。
{% load my_tags %}7、在 HTML 中使用自定義過濾器。
{{ 11|my_filter:22 }}8、在 HTML 中使用自定義標簽。
{% my_tag1 11 22 33 %}9、語義化標簽
在該 py 文件中導入 mark_safe。
from django.utils.safestring import mark_safe
定義標簽時,用上 mark_safe 方法,令標簽語義化,相當于 jQuery 中的 html() 方法。
和前端HTML文件中的過濾器 safe 效果一樣。
@register.simple_tag
def my_html(v1, v2):
temp_html = "<input type='text' id='%s' class='%s' />" %(v1, v2)
return mark_safe(temp_html)在HTML中使用該自定義標簽,在頁面中動態(tài)創(chuàng)建標簽。
{% my_html "zzz" "xxx" %}五、配置靜態(tài)文件
1、在項目根目錄下創(chuàng)建 statics 目錄。

2、在 settings 文件的最下方配置添加以下配置:
STATIC_URL = '/static/' # 別名
STATICFILES_DIRS = [
os.path.join(BASE_DIR, "statics"),
]
3、在 statics 目錄下創(chuàng)建 css 目錄,js 目錄,images 目錄,plugins 目錄, 分別放 css文件,js文件,圖片,插件。
4、把 bootstrap 框架放入插件目錄 plugins。
5、在 HTML 文件的 head 標簽中引入 bootstrap。
注意:此時引用路徑中的要用配置文件中的別名 static,而不是目錄 statics。
<link rel="stylesheet" href="/static/plugins/bootstrap-3.3.7-dist/css/bootstrap.css" rel="external nofollow" >
在模板中使用需要加入 {% load static %} 代碼,以下實例我們從靜態(tài)目錄中引入圖片。
HelloWorld/HelloWorld/views.py 文件代碼:
from django.shortcuts import render
def runoob(request):
name ="菜鳥教程"
return render(request, "runoob.html", {"name": name})HelloWorld/templates/runoob.html 文件代碼:
{% load static %}
{{name}}<img src="{% static "images/runoob-logo.png" %}" alt="runoob-logo">再訪問訪問 http://127.0.0.1:8000/runoob,可以看到頁面:

六、模板繼承
模板可以用繼承的方式來實現(xiàn)復用,減少冗余內(nèi)容。
網(wǎng)頁的頭部和尾部內(nèi)容一般都是一致的,我們就可以通過模板繼承來實現(xiàn)復用。
父模板用于放置可重復利用的內(nèi)容,子模板繼承父模板的內(nèi)容,并放置自己的內(nèi)容。
1、父模板
標簽 block...endblock: 父模板中的預留區(qū)域,該區(qū)域留給子模板填充差異性的內(nèi)容,不同預留區(qū)域名字不能相同。
{% block 名稱 %}
預留給子模板的區(qū)域,可以設置設置默認內(nèi)容
{% endblock 名稱 %}2、子模板
子模板使用標簽 extends 繼承父模板:
{% extends "父模板路徑"%}子模板如果沒有設置父模板預留區(qū)域的內(nèi)容,則使用在父模板設置的默認內(nèi)容,當然也可以都不設置,就為空。
子模板設置父模板預留區(qū)域的內(nèi)容:
{ % block 名稱 % }
內(nèi)容
{% endblock 名稱 %}接下來我們先創(chuàng)建之前項目的 templates 目錄中添加 base.html 文件,代碼如下:
HelloWorld/templates/base.html 文件代碼:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>菜鳥教程(runoob.com)</title>
</head>
<body>
<h1>Hello World!</h1>
<p>菜鳥教程 Django 測試。</p>
{% block mainbody %}
<p>original</p>
{% endblock %}
</body>
</html>以上代碼中,名為 mainbody 的 block 標簽是可以被繼承者們替換掉的部分。
所有的 {% block %} 標簽告訴模板引擎,子模板可以重載這些部分。
runoob.html 中繼承 base.html,并替換特定 block,runoob.html 修改后的代碼如下:
HelloWorld/templates/runoob.html 文件代碼:
{%extends "base.html" %}
{% block mainbody %}
<p>繼承了 base.html 文件</p>
{% endblock %}第一行代碼說明 runoob.html 繼承了 base.html 文件??梢钥吹剑@里相同名字的 block 標簽用以替換 base.html 的相應 block。
重新訪問地址 http://127.0.0.1:8000/runoob,輸出結(jié)果如下:

到此這篇關于Django框架模板用法的文章就介紹到這了。希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
python將中文數(shù)字轉(zhuǎn)化成阿拉伯數(shù)字的簡單方法
這篇文章主要給大家介紹了關于python如何將中文數(shù)字轉(zhuǎn)化成阿拉伯數(shù)字的相關資料,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2021-03-03
Python OpenCV利用筆記本攝像頭實現(xiàn)人臉檢測
這篇文章主要為大家詳細介紹了Python OpenCV利用筆記本攝像頭實現(xiàn)人臉檢測,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2019-04-04
Python實現(xiàn)為Excel中每個單元格計算其在文件中的平均值
這篇文章主要為大家詳細介紹了如何基于Python語言實現(xiàn)對大量不同的Excel文件加以跨文件、逐單元格平均值計算,感興趣的小伙伴可以跟隨小編一起學習一下2023-10-10
利用python實現(xiàn)PSO算法優(yōu)化二元函數(shù)
這篇文章主要介紹了python實現(xiàn)PSO算法優(yōu)化二元函數(shù)的代碼,非常不錯,具有一定的參考借鑒價值,需要的朋友可以參考下2019-11-11

