djiango的模板語言（template）

老師的博客：http://www.cnblogs.com/liwenzhou/p/7931828.html

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

 常用的語法

只需要記兩種特殊符號：

{{  }}和 {% %}

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

在views中的代碼

 

def test_templates(request):
    name="小蘋果"
    age=18
    list=["11.27","這是一個特殊的日子"]
    dic={'dxx':'dpg','lhy':'xpg'}
    class Person():
        def __init__(self,name,age):
            self.name=name
            self.age=age
        def __str__(self):
            return "{}的年齡是{}".format(self.name,self.age)
    p1=Person('alex',48)
    return render(request,"test_code.html",
                  {
                    'name':name,
                      "age":age,
                      "list":list,
                      "dict":dic,
                      "person1":p1,
                  })

 

當然支持在列表中放入對象，字典等等的語法

在HTML的代碼

<h1 class="text-center text-success">這是測試代碼</h1>
    <hr>
    <h2>常見測試</h2>
    <div class="text-danger">{{ name }}{{ age }}</div>
    <hr>
    <h2>list測試</h2>
    <div>{{ list }}{{ list.0 }}{{ list.1 }}</div>
    <hr>
    <h2>dict測試</h2>
    <div>{{ dict }}{{ dict.dxx }} {{ dict.lhy }}</div>
    <hr>
    <h2>class 測試</h2>
    <div>{{ person1 }}{{ person1.name }}{{ person1.age }}</div>

 注意：

由於在html中無法使用（），所以就無法使用帶參數的方法

效果圖：

這是測試代碼

---

常見測試

{{ name }}{{ age }}

---

list測試

{{ list }}{{ list.0 }}{{ list.1 }}

---

dict測試

{{ dict }}{{ dict.dxx }} {{ dict.lhy }}

---

class 測試

{{ person1 }}{{ person1.name }}{{ person1.age }}

 filters(過濾器)

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

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

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

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

注意事項：

1. 過濾器支持“鏈式”操作。即一個過濾器的輸出作為另一個過濾器的輸入。
2. 過濾器可以接受參數，例如：{{ sss|truncatewords:30 }}，這將顯示sss的前30個詞。
3. 過濾器參數包含空格的話，必須用引號包裹起來。比如使用逗號和空格去連接一個列表中的元素，如：{{ list|join:', ' }}
4. '|'左右沒有空格沒有空格沒有空格

 

 

default

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

{{ value|default:"nothing"}}

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

length

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

{{ value|length }}

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

filesizeformat

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

{{ value|filesizeformat }}

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

slice

切片

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

date

格式化

{{ 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：30 pm' / 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

 

safe

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

比如：

value = "<a href='#'>點我</a>"

{{ value|safe}}

truncatechars

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

參數：截斷的字符數

{{ value|truncatechars:9}}

truncatewords

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

{{ value|truncatewords:9}}

cut

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

{{ value|cut:' ' }}

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

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

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

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

{{ conference_date|timeuntil:from_date }}

 自定義filter：

首先創建函數：

在app中創建一個python的templatetags的文件夾（這個文件夾的名字一定是這個，python文件夾自帶__init__），然后自己新建一個python文件，名字自己取

例如：

上面有一個錯誤，就是在定義函數的時候，register寫成了registor，必須這么寫，否則報錯

from django import template
register = template.Library() #注冊

#告訴Djiango這個函數的名字是mmd
@register.filter(name="mmd")
def mmd1(arg,name):
    return "%s親了%s一下"%(arg,name)

然后在setting里面配置好相關的文件

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'app01.apps.App01Config',
    'app01.templatetags'
]

 

 我的app的名字就叫app01

然后就是使用的方法，在HTML中

{% load selffilter %}
<p>{{ dict.dxx|mmd:"xpg" }}</p>

dict.dxx|mmd:"xpg"中的dict.dxx是第一個參數，必須存在。mmd是函數的名字，‘xpg’是第二個參數

然后打開相關頁面既可以了：

有時候哦你會發現會出現下面的報錯代碼。

報錯代碼

TemplateSyntaxError at /test_templates/
'selffilter' is not a registered tag library. Must be one of:
admin_list
admin_modify
admin_static
admin_urls
cache
i18n
l10n
log
static
staticfiles
tz

 因為我們導入的時候，Django引進加載了，所以我們需要重行啟動Django，然后運行即可。

注意以下幾點

• 要把templatetags和register單詞寫對
• 在setting里面配置
• 在調用的時候要把先導入
• 調用函數的時候，不要加上空格

當然也可以編寫不帶參數和帶默認參數的函數，用法一樣，不會的話見老師的博客

tags

for循環

普通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判斷

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

注釋

{# ... #}

注意事項

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

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

 

但是支持以上的判斷

補充，在其他語法中的類是判斷

1.在python中
    a>b>c 先判斷a>b,在判斷b>c然后返回值
2.在js中
情況一：
    var a=100;
    var b=10;
    var c=1;
    conslog(a>b>c)
    false
情況二：
    var a=100;
    var b=10;
    var c=0;
    conslog(a>b>c)
    ture
在js中，是先判斷a>b然后返回false或者ture，然后，在轉化成1或者0，在進行下次判斷的

 

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

 如果沒有items：100時，data.items會取到所有的鍵值對

 母版

在HTML中有時會用到許多的頁面相互重復的內容比較多，所以這是就學要母版來解決問題了，以減少工作量。

首先自己先建立一個母版文件html文件。我們自己命名（such as base.html）

在母版的文件里面：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>base</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <script src="/static/jQuery.js"></script>
    <link href="/static/normalize.css" rel="stylesheet">
    <link href="/static/bootstrap/css/bootstrap.min.css" rel="stylesheet">
    <link href="/static/font-awesome/css/font-awesome.min.css" rel="stylesheet">
    <link href="/static/toastr/toastr.min.css" rel="stylesheet">
</head>
<body>
你的母版的內容
{% block main_content %}
{% endblock %}
你的母版內容
<script src="/static/bootstrap/js/bootstrap.min.js"></script>
<script src="/static/jQuery.js"></script>
<script src="/static/toastr/toastr.min.js"></script>
</body>
</html>

 

然后在正真的HTML文件中調用母版

{#引入母版文件#}
{% extends "base.html" %}
{% block main_content %}
{#你自己的內容#}
    <h1>你是我的小啊小蘋果，怎么愛你都不嫌多。</h1>
{% endblock %}

 

 注意：

1. 你的母版標題必須與引用的標題一致
2. 在引用html文件時，記得叫上“   ”
3. 我們通常會在母板中定義頁面專用的CSS塊和JS塊，方便子頁面替換。

組件

有時我們也會重復使用一些小型標簽內容，我們可以直接導入組件

{% include 'navbar.html' %}

 

 靜態文件相關

{% static %}

當我們的靜態文件改變別名時，這是我們一個一個改有點麻煩，就需要static

{#在setting里面找到靜態文件的別名#}
{% load static %}
{#拼接文件路徑#}
<img src="{% static "images/hi.jpg" %}" alt="Hi!" />

 

 

當文件名過長時，且多處用到時，我們需要 某個文存為一個變量

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

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

也是在templatetags下面建立一個自己的py文件，然后定義調用

定義注冊simple tag

from django import template
register = template.Library()
@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" %}

 注意

1. 定義時，是@register.simple_tag(name="plus") 而filter是@register.filter(name="mmd")
2. 調用方法的不一樣

inclusion_tag

多用於返回html代碼片段

示例：

同理，先在templatetags中建立一個py文件（inclusion_tag）

 然后定義：

from django import template
register=template.Library()

@register.inclusion_tag('inclusion_tags.html')
def show_results(n):
    n=1 if n < 1 else int(n)
    print(n)
    data = ["小蘋果么么噠*{}".format(i) for i in range(1,n+1)]
    return {"youcode": data}

 上面返回的是一個可迭代的對象。

然后在你上面寫的html（inclision_tag.html）文件中寫入一個代碼

<ul>題目
{% for i in youcode %}
<li>{{ i }}</li>
{% endfor %}
</ul>

 然后在render的HTML文件中的調用

    {% load inclusion_tag %}
    {% show_results 100 %}　　

 調用實現的步驟講解：

想把值給函數，然后返回給inclusion_tag.html文件中處理成html代碼，在返回給render的html文件。