官方文檔html
你可能已經注意到咱們在例子視圖中返回文本的方式有點特別。 也就是說,HTML被直接硬編碼在 Python代碼之中。前端
def current_datetime(request): now = datetime.datetime.now() html = "<html><body>It is now %s.</body></html>" % now return HttpResponse(html)
儘管這種技術便於解釋視圖是如何工做的,但直接將HTML硬編碼到你的視圖裏卻並非一個好主意。 讓咱們來看一下爲何:python
對頁面設計進行的任何改變都必須對 Python 代碼進行相應的修改。 站點設計的修改每每比底層 Python 代碼的修改要頻繁得多,所以若是能夠在不進行 Python 代碼修改的狀況下變動設計,那將會方便得多。git
Python 代碼編寫和 HTML 設計是兩項不一樣的工做,大多數專業的網站開發環境都將他們分配給不一樣的人員(甚至不一樣部門)來完成。 設計者和HTML/CSS的編碼人員不該該被要求去編輯Python的代碼來完成他們的工做。程序員
程序員編寫 Python代碼和設計人員製做模板兩項工做同時進行的效率是最高的,遠勝於讓一我的等待另外一我的完成對某個既包含 Python又包含 HTML 的文件的編輯工做。數據庫
基於這些緣由,將頁面的設計和Python的代碼分離開會更乾淨簡潔更容易維護。 咱們可使用 Django的 模板系統 (Template System)來實現這種模式,這就是本章要具體討論的問題django
python的模板:HTML代碼+模板語法bootstrap
def current_time(req): # ================================原始的視圖函數 # import datetime # now=datetime.datetime.now() # html="<html><body>如今時刻:<h1>%s.</h1></body></html>" %now # ================================django模板修改的視圖函數 # from django.template import Template,Context # now=datetime.datetime.now() # t=Template('<html><body>如今時刻是:<h1>{{current_date}}</h1></body></html>') # #t=get_template('current_datetime.html') # c=Context({'current_date':str(now)}) # html=t.render(c) # # return HttpResponse(html) #另外一種寫法(推薦) import datetime now=datetime.datetime.now() return render(req, 'current_datetime.html', {'current_date':str(now)[:19]})
模版語法重點:後端
變量:{{ 變量名 }}
1 深度查詢 用句點符
2 過濾器
標籤:{{% % }}
只須要記兩種特殊符號:
{{ }}和 {% %}
變量相關的用{{}},邏輯相關的用{%%}。
在 Django 模板中遍歷複雜數據結構的關鍵是句點字符, 語法:{{變量名}}
在Django的模板語言中按此語法使用:{{ 變量名 }}。
當模版引擎遇到一個變量,它將計算這個變量,而後用結果替換掉它自己。 變量的命名包括任何字母數字以及下劃線 ("_")的組合。 變量名稱中不能有空格或標點符號。
點(.)在模板語言中有特殊的含義。當模版系統遇到點("."),它將以這樣的順序查詢:
字典查詢(Dictionary lookup)
屬性或方法查詢(Attribute or method lookup)
數字索引查詢(Numeric index lookup)
注意事項:
幾個例子:
view中代碼:
def template_test(request): l = [11, 22, 33] d = {"name": "alex"} class Person(object): def __init__(self, name, age): self.name = name self.age = age def dream(self): return "{} is dream...".format(self.name) Alex = Person(name="Alex", age=34) Egon = Person(name="Egon", age=9000) Eva_J = Person(name="Eva_J", age=18) person_list = [Alex, Egon, Eva_J] return render(request, "template_test.html", {"l": l, "d": d, "person_list": person_list})
模板中支持的寫法:
{# 取l中的第一個參數 #} {{ l.0 }} {# 取字典中key的值 #} {{ d.name }} {# 取對象的name屬性 #} {{ person_list.0.name }} {# .操做只能調用不帶參數的方法 #} {{ person_list.0.dream }}
from datetime import datetime def loginn(request): n = 123 f = 12.12 s = "我是最帥的" l = [1, 2, 3, 4, 5, 6] d = {'username': "ocean", 'password': 123, 'hobby': ['sing', 'dance']} t = (1, 2, 3,) se = {1, 2, 4, 5} b = True ctime = datetime.now() def func(): print('嘿嘿嘿') return '哈哈哈' class Myclass(object): @classmethod def get_cls(cls): return 'cls' @staticmethod def get_func(): return 'func' def get_self(self): return 'self' obj = Myclass() return render(request, 'loginn.html', locals())
#loginn.html <p>{{ n }}</p> <p>{{ f }}</p> <p>{{ s }}</p> <p>{{ l }}</p> <p>{{ d }}</p> <p>{{ se }}</p> <p>{{ t }}</p> <p>{{ b }}</p> <p>{{ ctime }}</p> 若是傳遞給前端一個函數名 會直接加括號調用 將函數的返回值展現到前端 若是函數有參數 很差意思 django的模板語法 不支持給函數傳參 <p>{{ func }}</p> 方法不能傳參 <p>{{ obj }}</p> <p>{{ obj.get_cls }}</p> <p>{{ obj.get_func }}</p> <p>{{ obj.get_self }}</p> 模板能夠取值 #列表取值 <p>{{ l.1 }}</p> <p>{{ l.3 }}</p> #字典取值 <p>{{ d.username }}</p> <p>{{ d.password }}</p> <p>{{ d.hobby.1 }}</p>
在Django的模板語言中,經過使用 過濾器 來改變變量的顯示。
過濾器的語法: {{ value|filter_name:參數 }}
使用管道符"|"來應用過濾器。
例如:{{ name|lower }}會將name變量應用lower過濾器以後再顯示它的值。lower在這裏的做用是將文本全都變成小寫。
注意事項:
Django的模板語言中提供了大約六十個內置過濾器。
from datetime import datetime from django.utils.safestring import mark_safe # 告訴django這個字符串是安全的能夠被渲染 def loginn(request): n = 123 f = 12.12 s = "我是最帥的" s1 = 'ha' l = [1, 2, 3, 4, 5, 6] d = {'username': "ocean", 'password': 123, 'hobby': ['sing', 'dance']} t = (1, 2, 3,) se = {1, 2, 4, 5} b = True ctime = datetime.now() file_size = 341257896 # 文件大小而且,能夠求值 w = '奧術 大師件 大事肯德 基按 實際對 拉 螺栓空當接 龍' w1 = 'asdash ashd jkh sadas asdjjs had sjklad j a kjkjdsklas dkjsakldj dlsjakld ' w2 = "dfsafdfadfadfadfadfdfcvcvfggrad" btime = datetime.now() sss = "<h1>一臉懵逼</h1>" sss1 = "<script>alter('驚喜嘛')</script>" res = mark_safe(sss1) # 告訴django和html這個是安全的能夠解析 xo = '123456123' xo1 = '' x02 = 222 yyy = {'user_list': [1, '22', {'username': ['ocean', 'sing']}]} return render(request, 'loginn.html', locals())
若是一個變量是false或者爲空,使用給定的默認值。 不然,使用變量的值。有值就拿值 沒值就用後面默認的
{{ value|default:"nothing"}}
若是value沒有傳值或者值爲空的話就顯示nothing
返回值的長度,做用於字符串和列表。
{{ value|length }}
返回value的長度,如 value=['a', 'b', 'c', 'd']的話,就顯示4.
將值格式化爲一個 「人類可讀的」 文件尺寸 (例如 '13 KB'
, '4.1 MB'
, '102 bytes'
, 等等)。例如:
{{ value|filesizeformat }}
若是 value 是 123456789,輸出將會是 117.7 MB。
切片
{{value|slice:"2:-1"}}
格式化
{{ 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:30pm' / 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 |
Django的模板中會對HTML標籤和JS等語法標籤進行自動轉義,緣由顯而易見,這樣是爲了安全。可是有的時候咱們可能不但願這些HTML元素被轉義,好比咱們作一個內容管理系統,後臺添加的文章中是通過修飾的,這些修飾多是經過一個相似於FCKeditor編輯加註了HTML修飾符的文本,若是自動轉義的話顯示的就是保護HTML標籤的源文件。爲了在Django中關閉HTML的自動轉義有兩種方式,若是是一個單獨的變量咱們能夠經過過濾器「|safe」的方式告訴Django這段代碼是安全的沒必要轉義。
好比:
value = "點我"
{{ value|safe}}
若是字符串字符多於指定的字符數量,那麼會被截斷。截斷的字符串將以可翻譯的省略號序列(「...」)結尾。
參數:截斷的字符數
{{ value|truncatechars:9}}
在必定數量的字後截斷字符串。
{{ value|truncatewords:9}}
移除value中全部的與給出的變量相同的字符串
{{ value|cut:' ' }}
若是value爲'i love you',那麼將輸出'iloveyou'.
使用字符串鏈接列表,例如Python的str.join(list)
將日期格式設爲自該日期起的時間(例如,「4天,6小時」)。
採用一個可選參數,它是一個包含用做比較點的日期的變量(不帶參數,比較點爲如今)。 例如,若是blog_date是表示2006年6月1日午夜的日期實例,而且comment_date是2006年6月1日08:00的日期實例,則如下將返回「8小時」:
{{ blog_date|timesince:comment_date }}
分鐘是所使用的最小單位,對於相對於比較點的將來的任何日期,將返回「0分鐘」。
似於timesince,除了它測量從如今開始直到給定日期或日期時間的時間。 例如,若是今天是2006年6月1日,而conference_date是保留2006年6月29日的日期實例,則{{ conference_date | timeuntil }}將返回「4周」。
使用可選參數,它是一個包含用做比較點的日期(而不是如今)的變量。 若是from_date包含2006年6月22日,則如下內容將返回「1周」:
{{ conference_date|timeuntil:from_date }}
過濾器 | 描述 | 示例 |
---|---|---|
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 }}{{ False | yesno }}{{ None | yesno }} ``返回 ``yes``no ``maybe |
標籤看起來像是這樣的: {% tag %}
。標籤比變量更加複雜:一些在輸出中建立文本,一些經過循環或邏輯來控制流程,一些加載其後的變量將使用到的額外信息到模版中。一些標籤須要開始和結束標籤 (例如{% tag %} ...
標籤 內容 ... {% endtag %})。
普通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 %}
會對一個變量求值,若是它的值是「True」(存在、不爲空、且不是boolean類型的false值),對應的內容塊會輸出。
if語句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判斷。
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 total=business.employees.count %} {{ total }} employee{{ total|pluralize }} {% endwith %}
或
{% with business.employees.count as total %} {{ total }} employee{{ total|pluralize }} {% endwith %}
這個標籤用於跨站請求僞造保護。
在頁面的form表單裏面寫上{% csrf_token %}
自定義過濾器須要注意:
自定義過濾器只是帶有一個或兩個參數的Python函數:
例如,在過濾器{{var | foo:'bar'}}中,過濾器foo將傳遞變量var和參數「bar」。
自定義過濾器、標籤
步驟:
1 在應用名下面新建一個templatetags文件夾(必須叫這個名字)
2 在改文件夾下 新建一個任意名稱的py文件
3 在該py文件內 固定先寫兩行代碼
from django.template import Library register = Library()
一、在settings中的INSTALLED_APPS配置當前app,否則django沒法找到自定義的simple_tag.
二、在app中建立templatetags模塊(模塊名只能是templatetags)
三、建立任意 .py 文件,如:my_tags.py
from django.template import Library register = Library() @register.filter(name='myplus')#自定義過濾器 def index(a,b): return a + b @register.simple_tag(name='mysm')#自定義標籤 def login(a,b,c,d): return '%s/%s/%s/%s'%(a,b,c,d)
四、在使用自定義simple_tag和filter的html文件中導入以前建立的 my_tags.py
{% load my_tags %}
五、使用simple_tag和filter(如何調用)
{% load my_tag %} {#{{ 123|myplus:123 }}#} {#只要思想不滑坡 方法總比困難多#} {#{{ 123|myplus:'[1,2,3,4,5,6,7,8,]' }}#} {#{% load my_tag %}#} {% mysm 1 2 3 4 %} {% if 0|myplus:123 %}#可使用 <p>有值</p> {% endif %} {% if mysm 1 2 3 4 %}#不能使用 <p>有值</p> {% endif %}
注意:filter能夠用在if等語句後,simple_tag不能夠
{# ... #}
\1. Django的模板語言不支持連續判斷,即不支持如下寫法:
{% if a > b > c %} ... {% endif %}
\2. 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的值。
語法:{% include '模版名稱' %}
如:{% include 'adv.html' %}
<div class="adv"> <div class="panel panel-default"> <div class="panel-heading"> <h3 class="panel-title">Panel title</h3> </div> <div class="panel-body"> Panel content </div> </div> <div class="panel panel-danger"> <div class="panel-heading"> <h3 class="panel-title">Panel title</h3> </div> <div class="panel-body"> Panel content </div> </div> <div class="panel panel-warning"> <div class="panel-heading"> <h3 class="panel-title">Panel title</h3> </div> <div class="panel-body"> Panel content </div> </div> </div>
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> <link rel="stylesheet" href="/static/bootstrap-3.3.7-dist/css/bootstrap.min.css"> {# <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">#} <style> * { margin: 0; padding: 0; } .header { height: 50px; width: 100%; background-color: #369; } </style> </head> <body> <div class="header"></div> <div class="container"> <div class="row"> <div class="col-md-3"> {% include 'adv.html' %} </div> <div class="col-md-9"> {% block conn %} <h1>你好</h1> {% endblock %} </div> </div> </div> </body> </html>
{% extends 'base.html' %} {% block conn %} {{ block.super }} 是啊 {% endblock conn%}
在子頁面中在頁面最上方使用下面的語法來繼承母板。
{% extends 'layouts.html' %}
經過在母板中使用{% block xxx %}
來定義"塊"。
在子頁面中經過定義母板中的block名來對應替換母板中相應的內容。
{% block page-main %} <p>世情薄</p> <p>人情惡</p> <p>雨送黃昏花易落</p> {% endblock %}
能夠將經常使用的頁面內容如導航條,頁尾信息等組件保存在單獨的文件中,而後在須要使用的地方按以下語法導入便可。
{% include 'navbar.html' %}
Django模版引擎中最強大也是最複雜的部分就是模版繼承了。模版繼承可讓您建立一個基本的「骨架」模版,它包含您站點中的所有元素,而且能夠定義可以被子模版覆蓋的 blocks 。
經過從下面這個例子開始,能夠容易的理解模版繼承:
<!DOCTYPE html> <html lang="en"> <head> <link rel="stylesheet" href="style.css"/> <title>{% block title %}My amazing site{% endblock %}</title> </head> <body> <div id="sidebar"> {% block sidebar %} <ul> <li><a href="/">Home</a></li> <li><a href="/blog/">Blog</a></li> </ul> {% endblock %} </div> <div id="content"> {% block content %}{% endblock %} </div> </body> </html>
這個模版,咱們把它叫做 base.html
, 它定義了一個能夠用於兩列排版頁面的簡單HTML骨架。「子模版」的工做是用它們的內容填充空的blocks。
在這個例子中, block
標籤訂義了三個能夠被子模版內容填充的block。 block
告訴模版引擎: 子模版可能會覆蓋掉模版中的這些位置。
子模版可能看起來是這樣的:
{% extends "base.html" %} {% block title %}My amazing blog{% endblock %} {% block content %} {% for entry in blog_entries %} <h2>{{ entry.title }}</h2> <p>{{ entry.body }}</p> {% endfor %} {% endblock %}
extends
標籤是這裏的關鍵。它告訴模版引擎,這個模版「繼承」了另外一個模版。當模版系統處理這個模版時,首先,它將定位父模版——在此例中,就是「base.html」。
那時,模版引擎將注意到 base.html
中的三個 block
標籤,並用子模版中的內容來替換這些block。根據 blog_entries
的值,輸出可能看起來是這樣的:
<!DOCTYPE html> <html lang="en"> <head> <link rel="stylesheet" href="style.css" /> <title>My amazing blog</title> </head> <body> <div id="sidebar"> <ul> <li><a href="/">Home</a></li> <li><a href="/blog/">Blog</a></li> </ul> </div> <div id="content"> <h2>Entry one</h2> <p>This is my first entry.</p> <h2>Entry two</h2> <p>This is my second entry.</p> </div> </body> </html>
請注意,子模版並無定義 sidebar
block,因此係統使用了父模版中的值。父模版的 {% block %}
標籤中的內容老是被用做備選內容(fallback)。
這種方式使代碼獲得最大程度的複用,而且使得添加內容到共享的內容區域更加簡單,例如,部分範圍內的導航。
這裏是使用繼承的一些提示:
若是你在模版中使用 {% extends %}
標籤,它必須是模版中的第一個標籤。其餘的任何狀況下,模版繼承都將沒法工做。
在base模版中設置越多的 {% block %}
標籤越好。請記住,子模版沒必要定義所有父模版中的blocks,因此,你能夠在大多數blocks中填充合理的默認內容,而後,只定義你須要的那一個。多一點鉤子總比少一點好。
若是你發現你本身在大量的模版中複製內容,那可能意味着你應該把內容移動到父模版中的一個 {% block %}
中。
If you need to get the content of the block from the parent template, the {{ block.super }}
variable will do the trick. This is useful if you want to add to the contents of a parent block instead of completely overriding it. Data inserted using {{ block.super }}
will not be automatically escaped (see the next section), since it was already escaped, if necessary, in the parent template.
爲了更好的可讀性,你也能夠給你的 {% endblock %}
標籤一個 名字 。例如:
{% block content %} ... {% endblock content %}
在大型模版中,這個方法幫你清楚的看到哪個 {% block %}
標籤被關閉了。
不能在一個模版中定義多個相同名字的 block
標籤。
2.靜態文件配置 靜態文件 網站所用到的 本身寫好js 本身寫好css 第三方的框架 bootstrap fontwesome sweetalert,elementui,layui 一般狀況下 網站所用到的靜態文件資源 統一都放在static文件夾下 STATIC_URL = '/static/' # 是訪問靜態資源的接口前綴 """只要你想訪問靜態資源 你就必須以static開頭""" # 手動配置靜態文件訪問資源 STATICFILES_DIRS = [ os.path.join(BASE_DIR,'static'), os.path.join(BASE_DIR,'static1'), # os.path.join(BASE_DIR,'static2'), ] html中 接口前綴 動態解析,這樣能夠修改STATIC_URL,在html中依舊能夠檢測到css,js {% load static %} <link rel="stylesheet" href="{% static 'bootstrap/css/bootstrap.min.css' %}"> <script src="{% static 'bootstrap/js/bootstrap.min.js' %}"></script>
{% load static %} <img src="{% static "images/hi.jpg" %}" alt="Hi!" />
引用JS文件時使用:
{% load static %} <script src="{% static "mytest.js" %}"></script>
某個文件多處被用到能夠存爲一個變量
{% load static %} {% static "images/hi.jpg" as myphoto %} <img src="{{ myphoto }}"></img>
{% load static %} <img src="{% get_static_prefix %}images/hi.jpg" alt="Hi!" />
或者
{% load static %} {% get_static_prefix as STATIC_PREFIX %} <img src="{{ STATIC_PREFIX }}images/hi.jpg" alt="Hi!" /> <img src="{{ STATIC_PREFIX }}images/hi2.jpg" alt="Hello!" />
和自定義filter相似,只不過接收更靈活的參數。
定義註冊simple tag
@register.simple_tag(name="plus") def plus(a, b, c): return "{} + {} + {}".format(a, b, c)
使用自定義simple tag
{% load app01_demo %} {# simple tag #} {% plus "1" "2" "abc" %}
多用於返回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>