Django - 模板系統

時間 2019-12-14

標籤 django 模板系統欄目 Python 简体版

原文原文鏈接

1、經常使用語法

官方文檔：https://docs.djangoproject.com/en/1.11/ref/templates/builtins/#std:templatetag-forcss

只須要記兩種特殊符號：html

{{ }}和 {% %}django

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

變量

{{ 變量名 }}app

變量名由字母數字和下劃線組成。函數

點（.）在模板語言中有特殊的含義，用來獲取對象的相應屬性值。oop

幾個例子：ui

view中代碼：spa

 1 def template_test(request):
 2     l = [11, 22, 33]
 3     d = {"name": "alex"}
 4 
 5     class Person(object):
 6         def __init__(self, name, age):
 7             self.name = name
 8             self.age = age
 9 
10         def dream(self):
11             return "{} is dream...".format(self.name)
12 
13     Alex = Person(name="Alex", age=34)
14     Egon = Person(name="Egon", age=9000)
15     Eva_J = Person(name="Eva_J", age=18)
16 
17     person_list = [Alex, Egon, Eva_J]
18     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 }}

Filters

語法：翻譯

1 {{ value|filter_name:參數 }}

default

1 {{ value:default: "nothing"}}

若是value值沒傳的話就顯示nothing

length

1 {{ value|length }}

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

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

filesizeformat

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

1 {{ value|filesizeformat }}

若是 value 是 123456789，輸出將會是 117.7 MB。

slice

切片

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

date

格式化

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

safe

Django的模板中會對HTML標籤和JS等語法標籤進行自動轉義，緣由顯而易見，這樣是爲了安全。可是有的時候咱們可能不但願這些HTML元素被轉義，好比咱們作一個內容管理系統，後臺添加的文章中是通過修飾的，這些修飾多是經過一個相似於FCKeditor編輯加註了HTML修飾符的文本，若是自動轉義的話顯示的就是保護HTML標籤的源文件。爲了在Django中關閉HTML的自動轉義有兩種方式，若是是一個單獨的變量咱們能夠經過過濾器「|safe」的方式告訴Django這段代碼是安全的沒必要轉義。

好比：

1 value = "<a href='#'>點我</a>"
2 
3 {{ value|safe}}

Truncatechars

若是字符串字符多於指定的字符數量，那麼會被截斷。截斷的字符串將以可翻譯的省略號序列（「...」）結尾。

參數：截斷的字符數

1 {{ value|truncatechars:9}}

自定義filter

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

變量（輸入）的值 - -不必定是一個字符串
參數的值 - 這能夠有一個默認值，或徹底省略

例如，在過濾器{{var | foo：「bar」}}中，過濾器foo將傳遞變量var和參數「bar」。

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

1 app01/
2     __init__.py
3     models.py
4     templatetags/  # 在app01下面新建一個package package
5         __init__.py
6         app01_filters.py  # 建一個存放自定義filter的文件
7     views.py

編寫自定義filter

 1 from django import template
 2 register = template.Library()
 3 
 4 
 5 @register.filter(name="cut")
 6 def cut(value, arg):
 7     return value.replace(arg, "")
 8 
 9 
10 @register.filter(name="addSB")
11 def add_sb(value):
12     return "{} SB".format(value)

使用自定義filter

1 {# 先導入咱們自定義filter那個文件 #}
2 {% load app01_filters %}
3 
4 {# 使用咱們自定義的filter #}
5 {{ somevariable|cut:"0" }}
6 {{ d.name|addSB }}

Variable	Description
forloop.counter	當前循環的索引值（從1開始）
forloop.counter0	當前循環的索引值（從0開始）
forloop.revcounter	當前循環的倒序索引值（從1開始）
forloop.revcounter0	當前循環的倒序索引值（從0開始）
forloop.first	當前循環是否是第一次循環（布爾值）
forloop.last	當前循環是否是最後一次循環（布爾值）
forloop.parentloop	本層循環的外層循環

csrf_token

這個標籤用於跨站請求僞造保護。

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

註釋

{# ... #}

2、母板

模板使用

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4   <meta charset="UTF-8">
 5   <meta http-equiv="x-ua-compatible" content="IE=edge">
 6   <meta name="viewport" content="width=device-width, initial-scale=1">
 7   <title>Title</title>
 8   {% block page-css %}
 9   
10   {% endblock %}
11 </head>
12 <body>
13 
14 <h1>這是母板的標題</h1>
15 
16 {% block page-main %}
17 
18 {% endblock %}
19 <h1>母板底部內容</h1>
20 {% block page-js %}
21 
22 {% endblock %}
23 </body>
24 </html>

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

繼承模板

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

{% extends 'layouts.html' %}

3、塊（block）和組件

塊（block）

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

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

代碼示例：

1 {% block page-main %}
2   <p>世情薄</p>
3   <p>人情惡</p>
4   <p>雨送黃昏花易落</p>
5 {% endblock %}

組件

能夠將經常使用的頁面內容如導航條，頁尾信息等組件保存在單獨的文件中，而後在須要使用的地方按以下語法導入便可。

1 {% include 'navbar.html' %}

4、靜態文件相關

用法

1 {% load static %}
2 <img src="{% static "images/hi.jpg" %}" alt="Hi!" />
3 引用JS文件時使用：
4 {% load static %}
5 <script src="{% static "mytest.js" %}"></script>
6 某個文件多處被用到能夠存爲一個變量
7 {% load static %}
8 {% static "images/hi.jpg" as myphoto %}
9 <img src="{{ myphoto }}"></img>

使用get_static_prefix

1 {% load static %}
2 <img src="{% get_static_prefix %}images/hi.jpg" alt="Hi!" />
3 
4 或者
5 {% load static %}
6 {% get_static_prefix as STATIC_PREFIX %}
7 
8 <img src="{{ STATIC_PREFIX }}images/hi.jpg" alt="Hi!" />
9 <img src="{{ STATIC_PREFIX }}images/hi2.jpg" alt="Hello!" />

自定義simpletag

和自定義filter相似，只不過接收更靈活的參數。

定義註冊simple tag

1 @register.simple_tag(name="plus")
2 def plus(a, b, c):
3     return "{} + {} + {}".format(a, b, c)
4 使用自定義simple tag
5 {% load app01_demo %}
6 
7 {# simple tag #}
8 {% plus "1" "2" "abc" %}

inclusion_tag

多用於返回html代碼片斷

示例：

 1 templatetags/my_inclusion.py
 2 from django import template
 3 
 4 register = template.Library()
 5 
 6 
 7 @register.inclusion_tag('result.html')
 8 def show_results(n):
 9     n = 1 if n < 1 else int(n)
10     data = ["第{}項".format(i) for i in range(1, n+1)]
11     return {"data": data}
12 
13 templates/snippets/result.html
14 <ul>
15   {% for choice in data %}
16     <li>{{ choice }}</li>
17   {% endfor %}
18 </ul>
19 
20 templates/index.html
21 <!DOCTYPE html>
22 <html lang="en">
23 <head>
24   <meta charset="UTF-8">
25   <meta http-equiv="x-ua-compatible" content="IE=edge">
26   <meta name="viewport" content="width=device-width, initial-scale=1">
27   <title>inclusion_tag test</title>
28 </head>
29 <body>
30 
31 {% load inclusion_tag_test %}
32 
33 {% show_results 10 %}
34 </body>
35 </html>