Django 模板系統

Django模板系統

經常使用語法

　　{{}} 變量相關

　　{%%} 邏輯相關

變量

格式

{{ 變量名 }}

命名規則

包括任何字母數字以及下劃線 ("_")的組合

變量名稱中不能有空格或標點符號

示例

# view中代碼

def template_test(request): 
    a = [11, 22, 33] 
    d = {"name": "yangtuo"} 

class Person(object): 
    def __init__(self, name, age): 
        self.name = name 
    　　self.age = age 

　　def dream(self): 
　　　　return "{} is dream...".format(self.name) 

　　yangtuo = Person(name="yangtuo", age=14) 
　　yt = Person(name="yt", age=16) 
　　ytt = Person(name="ytt", age=18) 
　　person_list = [yangtuo, yt, ytt] 

　　return render(request, "template_test.html", {"a": l, "d": d, "person_list": person_list})        

{#模板中支持的寫法#} 

{# 取l中的第一個參數 #} 
{{ l.0 }}

{# 取字典中key的值 #} 
{{ d.name }} 

{# 取對象的name屬性 #}
{{ person_list.0.name }}

{# 操做只能調用不帶參數的方法 #} 
{{ person_list.0.dream }}

Filters（過濾器）

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

基本語法

{{ value|filter_name:參數 }}

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

注意點

　　　　過濾器支持「鏈式」操做。即一個過濾器的輸出做爲另外一個過濾器的輸入。

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

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

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

經常使用的過濾器

default

若是一個變量是false或者爲空，使用給定的默認值。 不然，使用變量的值。

若是value沒有傳值或者值爲空的話就顯示nothing

{{ value|default:"nothing"}}

length

返回值的長度，做用於字符串和列表。

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

{{ value|length }}

filesizeformat

將值格式化爲一個 「人類可讀的」 文件尺寸

例如  :  '13 KB', '4.1 MB', '102 bytes', 等等

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

{{ value|filesizeformat }}

slice

切片,切的時候須要加  " "  

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

date

格式化字符串以參數格式輸出,參數不少

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

 可選參數

safe

爲了安全起見,Django的模板中會對HTML標籤和JS等語法標籤進行自動轉義讓其沒法正確顯示爲標籤

可是有些HTML元素不但願被轉義的時候,可用safe做爲標識阻止Django模板的轉意

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

truncatechars

若是字符串字符多於指定的字符數量，那麼會被截斷。

截斷的字符串將以可翻譯的省略號序列（「...」）結尾

參數：截斷的字符數

 {{ value|truncatechars:9}}

cut

移除value中全部的與給出的變量相同的字符串

例如　　value爲'i love you'，那麼將輸出'iloveyou'.

參數　　被移除的字符串 

 {{ value|cut:' ' }}

 join

使用字符串鏈接列表，

例如　　Python的str.join(list)

timesince

表示出設定時間到參數時間的長度

將日期格式設爲自該日期起的時間（例如，「4天，6小時」）。

採用一個可選參數，它是一個包含用做比較點的日期的變量（不帶參數，比較點爲如今） 

可選參數

用做比較點的日期的變量

若無參數, 比較點爲如今

// 若是blog_date是表示2006年6月1日午夜的日期實例，
// 而且comment_date是2006年6月1日08:00的日期實例，則如下將返回「8小時」： 

{{ blog_date|timesince:comment_date }} // 分鐘是所使用的最小單位，對於相對於比較點的將來的任何日期，將返回「0分鐘」。

timeuntil

它測量從如今開始直到給定日期或日期時間的時間。 

 {{ conference_date | timeuntil }}

可選參數: 用做比較點的日期（而不是如今）的變量。

// 若是from_date包含2006年6月22日，則如下內容將返回「1周」：

{{ conference_date|timeuntil:from_date }}

自定義filter

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

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

參數的值                　　 -- 這能夠有一個默認值，或徹底省略

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

# 自定義filter代碼文件擺放位置 app01/templatetags/app01_filters.py  # 在自定義的app01_filters.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 }}

Tags

for循環 

普通for循環

<ul> {% for user in user_list %} 　　　　
　　<li>{{ user.name }}</li> 　　
　　　{% endfor %} 
</ul>

內置 forloop

forloop.counter               當前循環的索引值（從1開始）

forloop.counter0              當前循環的索引值（從0開始）

forloop.revcounter            當前循環的倒序索引值（從1開始）

forloop.revcounter0           當前循環的倒序索引值（從0開始）

forloop.first                 當前循環是否是第一次循環（布爾值）

forloop.last                  當前循環是否是最後一次循環（布爾值）

forloop.parentloop          　本層循環的外層循環

for ... empty

若是拿到的數據爲空,就用empty的內容代替

<ul> {% for user in user_list %} 　
　　　<li>{{ user.name }}</li> 　
　　　{% empty %} 　　　
　　　<li>空空如也</li> 　
　　　{% endfor %} 
</ul>

if 判斷

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

定義一箇中間變量，多用於給一個複雜的變量起別名。

注意等號左右不要加空格

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

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

csrf_token

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

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

注意事項

不支持鏈式操做

Django的模板語言不支持連續判斷，即不支持如下寫法：

 {% if a > b > c %} ... {% endif %}

屬性優先級大於方法

 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的值，而不是調用 d.items() 的結果

母版

會在母板中定義頁面專用的CSS塊和JS塊，方便子頁面替換。

<!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>Title</title>
　　 {% block page-css %} 　

　　 {% endblock %}
</head>

<body>
　　<h1>這是母板的標題</h1>
　　{% block page-main %} 　　　
　　{% endblock %} 　　

　　<h1>母板底部內容</h1>
　　{% block page-js %} 　　　　
　　{% endblock %} 
</body>
</html>

繼承母板

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

 {% extends 'layouts.html' %}

塊（block）

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

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

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

 組件

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

{% include 'navbar.html' %}

靜態文件

Django 配置

Django 不會自動建立 static 文件夾, 此文件夾都是手動建立所以須要配置到 Django 中才能夠被識別到

在 Django 的 settings.py 中須要作如下設置

# 靜態文件保存目錄的別名
STATIC_URL = '/static/'
 
# 全部靜態文件(css/js/圖片)都放在我下面你配置的文件夾中
STATICFILES_DIRS = [
　　os.path.join(BASE_DIR, "static"),
]

前端配置

{% static %} 

{% 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>

{% get_static_prefix %} 
{% 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!" />

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" %}

inclusion_tag

多用於返回html代碼片斷

使用場景

某段代碼須要被使用屢次（導航欄，左側菜單欄等）

使用方法

1. app下面建立templatetags（必須是這個名字）文件夾，而後建立一個自定義文件 my_tags.py，

　　經過 app01/templatetags/my_tags.py 進行數據的傳入 ，

from django import template from app01.models import User


register = template.Library() # 裝飾器方式 @register.inclusion_tag('t.html') def task_l(): 
　　user_list = User.objects.all() 
　　return {'user_list':user_list} 

# 直接註冊方式  # register.inclusion_tag('t.html')(task_l)

2. 而後建立一個 t.html 文件來承載要被使用的 HTML 代碼

<select>  
　　{% for user in user_list %}
<option value ="">{{ user.name }}</option>  
　　{% endfor %}
</select>

3. 要用到代碼的地方經過引入的方式拿到 t.html 中的代碼 添加在指定位置　

{% load  py文件名 %}

{% 自定義py文件名中的 函數名 %}

{% load mytag %} {% task_l %}

注意事項

使用此方法能夠有效的避免多段請求的時候拿不到數據的問題

問題場景

經過外部引入的靜態文件的的數據由於有沒有render的渲染，

{{ }} {% %} 的數據都沒法從後端拿到。只能一字符串的形式被瀏覽器渲染呈如今前端，

使用 inclusion_tag 能夠進行 render 獲取到數據