一、Django模板系統

官方文檔

二、常用語法

只需要記兩種特殊符號：

{{? }}和?{% %}

變量相關的用{{}}，邏輯相關的用{%%}。

1、變量

在Django的模板語言中按此語法使用：{{ 變量名 }}。

當模版引擎遇到一個變量，它將計算這個變量，然后用結果替換掉它本身。 變量的命名包括任何字母數字以及下劃線 ("_")的組合。 變量名稱中不能有空格或標點符號。

點（.）在模板語言中有特殊的含義。當模版系統遇到點(".")，它將以這樣的順序查詢：

字典查詢（Dictionary lookup）

屬性或方法查詢（Attribute or method lookup）

數字索引查詢（Numeric index lookup）

注意事項：

如果計算結果的值是可調用的，它將被無參數的調用。 調用的結果將成為模版的值。

如果使用的變量不存在， 模版系統將插入 string_if_invalid 選項的值， 它被默認設置為'' (空字符串) 。

幾個例子：

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?}}

2、Filters（過濾器）

在Django的模板語言中，通過使用?過濾器?來改變變量的顯示。

過濾器的語法： {{ value|filter_name:參數 }}

使用管道符"|"來應用過濾器。

例如：{{ name|lower }}會將name變量應用lower過濾器之后再顯示它的值。lower在這里的作用是將文本全都變成小寫。

注意事項：

過濾器支持“鏈式”操作。即一個過濾器的輸出作為另一個過濾器的輸入。

過濾器可以接受參數，例如：{{ sss|truncatewords:30 }}，這將顯示sss的前30個詞。

過濾器參數包含空格的話，必須用引號包裹起來。比如使用逗號和空格去連接一個列表中的元素，如：{{ list|join:', ' }}

'|'左右沒有空格沒有空格沒有空格

Django的模板語言中提供了大約六十個內置過濾器。

1）、default

如果一個變量是false或者為空，使用給定的默認值。 否則，使用變量的值。

{{?value|default:"nothing"}}

如果value沒有傳值或者值為空的話就顯示nothing

2）、length

返回值的長度，作用于字符串和列表。

{{ value|length }}

返回value的長度，如 value=['a',?'b',?'c',?'d']的話，就顯示4.

3）、filesizeformat

將值格式化為一個 “人類可讀的” 文件尺寸 （例如?'13 KB',?'4.1 MB',?'102 bytes', 等等）。例如：

{{?value|filesizeformat?}}

如果 value 是 123456789，輸出將會是 117.7 MB。

4）、slice

切片

{{value|slice:"2:-1"}}

5）、date

格式化

{{?value|date:"Y-m-d?H:i:s"}}

可用的參數：

6、safe

Django的模板中會對HTML標簽和JS等語法標簽進行自動轉義，原因顯而易見，這樣是為了安全。但是有的時候我們可能不希望這些HTML元素被轉義，比如我們做一個內容管理系統，后臺添加的文章中是經過修飾的，這些修飾可能是通過一個類似于FCKeditor編輯加注了HTML修飾符的文本，如果自動轉義的話顯示的就是保護HTML標簽的源文件。為了在Django中關閉HTML的自動轉義有兩種方式，如果是一個單獨的變量我們可以通過過濾器“|safe”的方式告訴Django這段代碼是安全的不必轉義。

比如：

value = "點我"

{{?value|safe}}

7、truncatechars

如果字符串字符多于指定的字符數量，那么會被截斷。截斷的字符串將以可翻譯的省略號序列（“...”）結尾。

參數：截斷的字符數

{{?value|truncatechars:9}}

8、truncatewords

在一定數量的字后截斷字符串。

{{?value|truncatewords:9}}

9、cut

移除value中所有的與給出的變量相同的字符串

{{?value|cut:'?'?}}

如果value為'i love you'，那么將輸出'iloveyou'.

10、join

使用字符串連接列表，例如Python的str.join(list)

11、timesince

將日期格式設為自該日期起的時間（例如，“4天，6小時”）。

采用一個可選參數，它是一個包含用作比較點的日期的變量（不帶參數，比較點為現在）。 例如，如果blog_date是表示2006年6月1日午夜的日期實例，并且comment_date是2006年6月1日08:00的日期實例，則以下將返回“8小時”：

{{?blog_date|timesince:comment_date?}}

分鐘是所使用的最小單位，對于相對于比較點的未來的任何日期，將返回“0分鐘”。

12、timeuntil

似于timesince，除了它測量從現在開始直到給定日期或日期時間的時間。 例如，如果今天是2006年6月1日，而conference_date是保留2006年6月29日的日期實例，則{{ conference_date | timeuntil }}將返回“4周”。

使用可選參數，它是一個包含用作比較點的日期（而不是現在）的變量。 如果from_date包含2006年6月22日，則以下內容將返回“1周”：

{{?conference_date|timeuntil:from_date?}}

13、自定義filter

自定義過濾器只是帶有一個或兩個參數的Python函數:

變量（輸入）的值 - -不一定是一個字符串

參數的值 - 這可以有一個默認值，或完全省略

例如，在過濾器{{var | foo:'bar'}}中，過濾器foo將傳遞變量var和參數“bar”。

自定義filter代碼文件擺放位置：

app01/ ????__init__.py ????models.py ????templatetags/??#?在app01下面新建一個package?package ????????__init__.py ????????app01_filters.py??#?建一個存放自定義filter的文件 ????views.py

編寫自定義filter

from?django?import?template register?=?template.Library() @register.filter(name="cut") def?cut(value,?arg): ????return?value.replace(arg,?"") @register.filter(name="addSB") def?add_sb(value): ????return?"{}?SB".format(value)

使用自定義filter

{#?先導入我們自定義filter那個文件?#} {%?load?app01_filters?%} {#?使用我們自定義的filter?#} {{?somevariable|cut:"0"?}} {{?d.name|addSB?}}

3、Tags

1）、for循環

普通for循環

????{%?for?user?in?user_list?%} ????????
• ????????????{{?user.name?}} ????????
????{%?endfor?%}

for循環可用的一些參數：

for ... empty

{%?for?user?in?user_list?%} ????
• {{?user.name?}}
{%?empty?%} ????
• 空空如也
{%?endfor?%}

2）、if判斷

if,elif和else

{%?if?user_list?%} ??用戶人數：{{?user_list|length?}} {%?elif?black_list?%} ??黑名單數：{{?black_list|length?}} {%?else?%} ??沒有用戶 {%?endif?%}{%?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判斷。

3、with

定義一個中間變量，多用于給一個復雜的變量起別名。

注意等號左右不要加空格。

{%?with?total=business.employees.count?%} ????{{?total?}}?employee{{?total|pluralize?}} {%?endwith?%}

或

{%?with?business.employees.count?as?total?%} ????{{?total?}}?employee{{?total|pluralize?}} {%?endwith?%}

4、csrf_token

這個標簽用于跨站請求偽造保護。

在頁面的form表單里面寫上{% csrf_token %}

5、注釋

{#?...?#}

6、注意事項

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的值。

4、母板

?? ?? ?? ?? ??{%?block?page-css?%}?? ??{%?endblock?%}

這是母板的標題

{%?block?page-main?%} {%?endblock?%}

母板底部內容

{%?block?page-js?%} {%?endblock?%}

注意：我們通常會在母板中定義頁面專用的CSS塊和JS塊，方便子頁面替換。

5、繼承母板

在子頁面中在頁面最上方使用下面的語法來繼承母板。

{%?extends?'layouts.html'?%}

6、塊（block）

通過在母板中使用{% block? xxx %}來定義"塊"。

在子頁面中通過定義母板中的block名來對應替換母板中相應的內容。

{%?block?page-main?%} ??

世情薄

??

人情惡

??

雨送黃昏花易落

{%?endblock?%}

7、組件

可以將常用的頁面內容如導航條，頁尾信息等組件保存在單獨的文件中，然后在需要使用的地方按如下語法導入即可。

{%?include?'navbar.html'?%}

8、靜態文件相關

1）、{% static %}

{%?load?static?%}

引用JS文件時使用：

{%?load?static?%}

某個文件多處被用到可以存為一個變量

{%?load?static?%} http://m.bai1xia.com/news/zb_users/upload/2022/05/20220530224256_36563.jpg"?as?myphoto?%}

或者

{%?load?static?%} {%?get_static_prefix?as?STATIC_PREFIX?%}

9、simple_tag

和自定義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"?%}

10、inclusion_tag

多用于返回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?

templates/snippets/result.html

??{%?for?choice?in?data?%} ??????
• {{?choice?}}
??{%?endfor?%}

templates/index.html

?? ?? ?? ?? {%?load?inclusion_tag_test?%} {%?show_results?10?%}

軟件開發 人工智能 云計算 機器學習

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。