目錄

• Django的templates（模板）
• 模板傳值
• 模板過濾器
• 模板語法之標簽
  • 常用標簽之for標簽
  • 常用標簽之if標簽
  • 常用標簽之with標簽
• 自定義過濾器和標簽
• 模板的繼承和導入
  • 模板的導入之include標簽
  • 模板的繼承/派生之extends標簽，block標簽
• 自定義char
• 特殊參數choices

Django的templates（模板）

django的模板=HTML代碼+模板語法

存放於templates目錄下的html文件稱之為模板文件

如果我們想要返回的html頁面中的數據是動態的，那么必須在html頁面中嵌入變量，這便用到了django的模板語法

• 變量

  模板語法符號：{{ 變量名 }}，變量相關

  ​ 1.1 深度查詢：句點符的應用
  ​ 1.2 過濾器

• 標簽

  模板語法符號：{% 標簽名 %}，邏輯相關

• 自定義標簽和過濾器

• 模板的導入和繼承

模板傳值

變量相關 {{ }}

如果html代碼中的數據不是固定死的，而是動態變化的

則必須在html中嵌入變量，為此，模板語法提供了變量的概念，允許我們在html代碼中嵌入變量

我們只需要在視圖函數中用render方法為html文件中指定的變量賦值即可，具體用法如下

test.html

<p>{{ msg }}</p>
<p>{{ dic }}</p>

我們需要在視圖函數中為模板test.html的變量名msg、dic、賦值,views.py內容如下

from django.shortcuts import render

def test(request):
	# 傳給模板的變量值可以是任意python類型，如下
	msg='hello world'
    dic={'k1':1,'k2':2}
	return render(request,'test.html',{'msg':msg, 'dic':dic})   #指名道姓
	#return render(request,'test.html',locals())  # locals會將當前名稱空間中所有的變量名全部傳遞給html頁面

注意：

1、render函數的第三個參數包含了要傳給模板的變量值，是一個字典類型

該字典中的key必須與模板文件中的變量名相對應，render函數會去templates目錄下找到模板文件，然后根據字典中的key對應到模板文件中的變量名進行賦值操作，最后將賦值后的模板文件內容返回給瀏覽器

2、可以將render函數的第三個參數簡寫為locals(),如下

return render(request,'test.html',locals())

locals()會將函數test內定義的所有名字與值轉換為字典中的k與v

句點符的使用

django模板語法取值 只有一種操作方式 句點符 .

句點符既可以引用容器類型的元素，也可以引用對象的方法

注意：當模板系統遇到一個（.）時，會按照如下的順序去查詢：

• 在字典中查詢
• 屬性或者方法
• 數字索引

<!--調用字符串對象的upper方法，注意不要加括號，函數和對象會自動加括號-->
<p>{{ msg.upper }}</p>

<!--取字典中k1對應的值-->
<p>{{ dic.k1 }}</p>

<!--取對象的name屬性-->
<p>{{ obj.name }}</p>

<!--取列表的第2個元素,然后變成大寫-->
<p>{{ li.1.upper }}</p>

<!--取列表的第3個元素，並取該元素的age屬性-->
<p>{{ li.2.age }}</p>

模板過濾器

過濾器類似於python的內置函數，用來把視圖傳入的變量值 加以修飾后再顯示

{{ 變量名|過濾器名:傳給過濾器的參數 }}
| 左邊的會當做過濾器的第一個參數,過濾器名右邊的會當做過濾器的第二個參數

常用內置過濾器

1 default

作用：如果一個變量值是False或者為空，使用default后指定的默認值，否則，使用變量本身的值

如果value= ’ ‘ ,則輸出“nothing”

{{ value|default:"nothing" }}

2 length

作用：返回值的長度。它對字符串、列表、字典等容器類型都起作用

如果value是 ['a', 'b', 'c', 'd']，那么輸出是4

{{ value|length }} 

3 filesizeformat

作用：將值的格式化為一個"人類可讀的"文件尺寸(如13KB、4.1 MB、102bytes等等）

如果 value 是 12312312321，輸出將會是 11.5 GB

{{ value|filesizeformat }} 

4 date

作用：將日期按照指定的格式輸出，如果value=datetime.datetime.now(),

按照格式Y-m-d則輸出2020-01-07

 {{ value|date:"Y-m-d" }}　　 

5 slice

作用：對輸出的字符串進行切片操作，顧頭不顧尾,

如果value=“santa“，則輸出"sa"

{{ value|slice: '0:2' }}

6 truncatechars

作用：如果字符串字符多於指定的字符數量，那么會被截斷。

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

如果value=”hello world santa“，則輸出"hello...",注意8個字符也包含末尾的3個點

{{ value|truncatechars:8 }}

7 truncatewords

作用：同truncatechars，但truncatewords是按照單詞截斷，注意末尾的3個點不算作單詞

如果value=”hello world santa“，則輸出"hello world ..."

 {{ value|truncatewords:2 }}

8 safe

作用：出於安全考慮，Django的模板會對HTML標簽、JS等語法標簽進行自動轉義,例如

value="<script>alert(123)</script>"，模板變量{{ value }}會被渲染成<script>alert(123)</script>交給瀏覽器后會被解析成普通字符”<script>alert(123)</script>“，失去了js代碼的語法意義，但如果我們就想讓模板變量{{ value }}被渲染的結果又語法意義，那么就用到了過濾器safe

比如value='<a href="https://www.baidu.com">點我啊</a>'，在被safe過濾器處理后就成為了真正的超鏈接，不加safe過濾器則會當做普通字符顯示’<a href="https://www.baidu.com">點我啊</a>‘

{{ value|safe }}

其他過濾器（了解）

過濾器	描述	示例
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轉義，比如將”<”轉換為”&lt”
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 }} 返回HiDavid
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標簽	{{ 'This is a pen' | truncatewords:2 }}返回``This is ...
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

模板語法之標簽

邏輯相關

標簽是為了在模板中完成一些特殊功能,語法為{% 標簽名 %}，一些標簽還需要搭配結束標簽 {% endtag %}

常用標簽之for標簽

1 遍歷每一個元素

{% for person in person_list %}
    <p>{{ person.name }}</p>
{% endfor %}

2 遍歷一個字典

{% for key,val in dic.items %}
    <p>{{ key }}:{{ val }}</p>
{% endfor %}

4 循環序號可以通過{{ forloop }}顯示　

forloop.counter            當前循環的索引值（從1開始）
forloop.counter0           當前循環的索引值（從0開始）
forloop.revcounter         當前循環的倒序索引值（從1開始）
forloop.revcounter0        當前循環的倒序索引值（從0開始）
forloop.first              當前循環是第一次循環則返回True，否則返回False
forloop.last               當前循環是最后一次循環則返回True，否則返回False
forloop.parentloop         本層循環的外層循環

5 for標簽可以帶有一個可選的{% empty %} 從句，在變量person_list為空或者沒有被找到時，則執行empty子句

{% for person in person_list %}
    <p>{{ person.name }}</p>

{% empty %}
    <p>sorry,no person here</p>
{% endfor %}

常用標簽之if標簽

1、注意：
{% if 條件 %}條件為真時if的子句才會生效，條件也可以是一個變量，if會對變量進行求值，在變量值為空、或者視圖沒有為其傳值的情況下均為False

2、具體語法
{% if num > 100 or num < 0 %}
    <p>無效</p>
{% elif num > 80 and num < 100 %}
    <p>優秀</p>
{% else %}
    <p>湊活吧</p>
{% endif %}

3、if語句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判斷。

常用標簽之with標簽

# with標簽用來為一個復雜的變量名起別名,如果變量的值來自於數據庫，在起別名后只需要使用別名即可，無需每次都向數據庫發送請求來重新獲取變量的值
{% with li.1.upper as v %}
    {{ v }}
{% endwith %}

自定義過濾器和標簽

當內置的過濾器或標簽無法滿足我們需求時，我們可以自定義

1 在應用名下新建一個名字必須為templatetags的文件夾(文件夾名只能是templatetags)

2 在templatetags新建任意.py文件，如my_tags.py，在該文件中自定義過濾器或標簽

from django.template import Library
register = Library()  # 注意變量名必須為register,不可改變

#1、自定義過濾器
@register.filter(name='my_filter')
def my_multi_filter(v1 ,v2): # 自定義的過濾器只能定義最多兩個參數,針對{{ value1 | filter_multi:value2 }}，參數傳遞為v1=value1,v2=value2
    return  v1 * v2
@register.filter(name='my_filter')    # 相當於更改了函數名，使用時，使用新的函數名


#2、自定義標簽
和自定義filter類似，區別：接收的參數更靈活，能接收萬能參數
@register.simple_tag(name='my_tag')
def my_multi_tag(v1, v2, v3): # 自定義的標簽可以定義多個參數
    return '%s?%s?%s?'%(v1, v2, v3)

#3、自定義inclusion_tag
@register.inclusion_tag('demo.html',name='my_inclu')
def index(n):
	li = []
	for i in range(n):
		li.append(i)
		#將列表傳遞給demo.html
		return {'li': li}

自定義過濾器或標簽必須重新啟動django方可生效

自定義過濾或標簽的使用

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<!--必須先加載存有自定義過濾器和標簽的文件-->
{% load my_tags %}
    
<!--salary的值為10，經過濾器my_multi_filter的處理結果為120-->
    自定義過濾器的使用
{{ salary|my_filter:12 }}
    
    自定義標簽的使用
{% my_tag 1 2 3 'hello baby' %}
    
    自定義inclusion_tag的使用
{% my_inclu 5 %}

對比自定義標簽與自定義過濾器

#1、自定義過濾器只能傳兩個參數，而自定義標簽卻可以傳多個參數

#2、過濾器可以用於if判斷，而標簽不能
{% if salary|my_multi_filter:12 > 200 %}
    <p>優秀</p>
{% else %}
    <p>垃圾</p>
{% endif %}

模板的繼承和導入

在實際開發中，模板文件彼此之間可能會有大量冗余代碼，為此django提供了專門的語法來解決這個問題,主要圍繞三種標簽的使用：include標簽、extends標簽、block標簽

模板的導入之include標簽

作用：在一個模板文件中，引入/重用另外一個模板文件的內容，

{% include '模版名稱m.html' %}

模板的繼承/派生之extends標簽，block標簽

當某一個頁面大部分區域都是公用的，那這個頁面就可以作為模板頁面

當別人繼承這個頁面后，要修改對應的區域

先在模板頁面上通過block實現划定區域

{% block content %}	
	模板頁面內容
{% endblock %}

子頁面中先導入真個模板

{% extends '模板頁面.html'%}
修改特定的區域  通過實現划定好的區域名稱
{% block content %}
	子頁面內容
{% endblock %}

通常情況下，模板頁面應該起碼有三塊區域

{% block css %}	
	模板頁面內容
{% endblock %}
{% block content %}	
	模板頁面內容
{% endblock %}
{% block js %}	
	模板頁面內容
{% endblock %}

模板的block塊越多 可擴展性越高

還支持子頁面調用父頁面對應區域的內容 並且可以無限次調用

      {{ block.super }}

自定義char

from django.db.models import Field

class MyCharField(Field):
	def __init__(self,max_length,*args,**kwargs):
        self.max_length = max_length #攔截一個父類的方法 操作完之后 利用super調用父類的方法
        super().__init__(max_length=max_length,*args,**kwargs)

    def db_type(self, connection):
		return 'char(%s)'%self.max_length

class Movie(models.Model):
	textField = MyCharField(max_length=32)

特殊參數choices

1、定義字段時，指定參數choices

2、choices的值為元組套元組（事先定義好，一般在該表類中定義該字段之前定義）

3、每一個元組存放兩個元素，形成一種對應關系

4、往數據庫中存值時，該字段的值存為元組第一個元素即可

5、通過方式對象.get_字段名_display()獲取對應的元組第二個元素值，當沒有對應關系時，返回的是它本身

		class Userinfo(models.Model):
			username = models.CharField(max_length=32)
			gender_choices = (
				(1,'男'),
				(2,'女'),
				(3,'其他'),
			)
			gender = models.IntegerField(choices=gender_choices)
			# 該字段還是存數字 並且可以匹配關系之外的數字
			record_choices = (('checked', "已簽到"),
				  ('vacate', "請假"),
				  ('late', "遲到"),
				  ('noshow', "缺勤"),
				  ('leave_early', "早退"),
				  )
			record = models.CharField("上課紀錄", choices=record_choices, default="checked", max_length=64)
		
		user_obj = models.Userinfo.objects.get(pk=1)
		print(user_obj.username)
		print(user_obj.gender)
		# 針對choices參數字段 取值的時候   get_xxx_display()
		print(user_obj.get_gender_display())
		# 針對沒有注釋信息的數據  get_xxx_display()獲取到的還是數字本身
		user_obj = models.Userinfo.objects.get(pk=4)
		print(user_obj.gender)
		print(user_obj.get_gender_display())