模版常用過濾器
在模版中,有時候需要對一些數據進行處理以后才能使用。一般在Python
中我們是通過函數的形式來完成的。而在模版中,則是通過過濾器來實現的。過濾器使用的是|來使用。
add
將傳進來的參數添加到原來的值上面。這個過濾器會嘗試將值和參數轉換成整形然后進行相加。如果轉換成整形過程中失敗了,那么會將值和參數進行拼接。如果是字符串,那么會拼接成字符串,如果是列表,那么會拼接成一個列表。示例代碼如下:
{{ value|add:"2" }}
如果value
是等於4,那么結果將是6。如果value是等於一個普通的字符串,比如abc
,那么結果將是abc2
。add過濾器的源代碼如下:
def add(value, arg):
"""Add the arg to the value."""
try:
return int(value) + int(arg)
except (ValueError, TypeError):
try:
return value + arg
except Exception:
return ''
cut
移除值中所有指定的字符串。類似於python
中的replace(args,"")
。示例代碼如下:
{{ value|cut:" " }}
以上示例將會移除value
中所有的空格字符。cut過濾器的源代碼如下:
def cut(value, arg):
"""Remove all values of arg from the given string."""
safe = isinstance(value, SafeData)
value = value.replace(arg, '')
if safe and arg != ';':
return mark_safe(value)
return value
date
將一個日期按照指定的格式,格式化成字符串。示例代碼如下:
# 數據
context = {
"birthday": datetime.now()
}
# 模版
{{ birthday|date:"Y/m/d" }}
那么將會輸出2018/02/01
。其中Y代表的是四位數字的年份,m代表的是兩位數字的月份,d代表的是兩位數字的日。
還有更多時間格式化的方式。見下表。
格式字符 | 描述 | 示例 |
---|---|---|
Y | 四位數字的年份 | 2020 |
m | 兩位數字的月份 | 01-12 |
n | 月份,1-9前面沒有0前綴 | 1-12 |
d | 兩位數字的天 | 01-31 |
j | 天,但是1-9前面沒有0前綴 | 1-31 |
g | 小時,12小時格式的,1-9前面沒有0前綴 | 1-12 |
h | 小時,12小時格式的,1-9前面有0前綴 | 01-12 |
G | 小時,24小時格式的,1-9前面沒有0前綴 | 1-23 |
H | 小時,24小時格式的,1-9前面有0前綴 | 01-23 |
i | 分鍾,1-9前面有0前綴 | 00-59 |
s | 秒,1-9前面有0前綴 | 00-59 |
default
如果值被評估為False
。比如[]
,""
,None
,{}
等這些在if
判斷中為False
的值,都會使用default
過濾器提供的默認值。示例代碼如下:
{{ value|default:"nothing" }}
如果value
是等於一個空的字符串。比如""
,那么以上代碼將會輸出nothing
。
default_if_none
如果值是None
,那么將會使用default_if_none
提供的默認值。這個和default
有區別,default
是所有被評估為False
的都會使用默認值。而default_if_none
則只有這個值是等於None
的時候才會使用默認值。示例代碼如下:
{{ value|default_if_none:"nothing" }}
如果value
是等於""
也即空字符串,那么以上會輸出空字符串。如果value
是一個None
值,以上代碼才會輸出nothing
。
first
返回列表/元組/字符串中的第一個元素。示例代碼如下:
{{ value|first }}
如果value是等於['a','b','c']
,那么輸出將會是a。
last
返回列表/元組/字符串中的最后一個元素。示例代碼如下:
{{ value|last }}
如果value
是等於['a','b','c']
,那么輸出將會是c。
floatformat
使用四舍五入的方式格式化一個浮點類型。如果這個過濾器沒有傳遞任何參數。那么只會在小數點后保留一個小數,如果小數后面全是0,那么只會保留整數。當然也可以傳遞一個參數,標識具體要保留幾個小數。
- 如果沒有傳遞參數:
value | 模版代碼 | 輸出 |
---|---|---|
34.23234 | {{ value|floatformat }} | 34.2 |
34.000 | {{ value|floatformat }} | 34 |
34.260 | {{ value|floatformat }} | 34.3 |
- 如果傳遞參數:
value | 模版代碼 | 輸出 |
---|---|---|
34.23234 | {{ value|floatformat:3 }} | 34.232 |
34.000 | {{ value|floatformat:3 }} | 34.000 |
34.26000 | {{ value|floatformat:3 }} | 34.260 |
join
類似與Python
中的join
,將列表/元組/字符串用指定的字符進行拼接。示例代碼如下:
{{ value|join:"/" }}
如果value
是等於['a','b','c']
,那么以上代碼將輸出a/b/c。
length
獲取一個列表/元組/字符串/字典的長度。示例代碼如下:
{{ value|length }}
如果value
是等於['a','b','c']
,那么以上代碼將輸出3。如果value
為None
,那么以上將返回0。
lower
將值中所有的字符全部轉換成小寫。示例代碼如下:
{{ value|lower }}
如果value
是等於Hello World
。那么以上代碼將輸出hello world
。
upper
類似於lower,只不過是將指定的字符串全部轉換成大寫。
random
在被給的列表/字符串/元組中隨機的選擇一個值。示例代碼如下:
{{ value|random }}
如果value
是等於['a','b','c']
,那么以上代碼會在列表中隨機選擇一個。
safe
標記一個字符串是安全的。也即會關掉這個字符串的自動轉義。示例代碼如下:
{{value|safe}}
如果value
是一個不包含任何特殊字符的字符串,比如<a>
這種,那么以上代碼就會把字符串正常的輸入。如果value
是一串html
代碼,那么以上代碼將會把這個html
代碼渲染到瀏覽器中。
slice
類似於Python
中的切片操作。示例代碼如下:
{{ some_list|slice:"2:" }}
以上代碼將會給some_list
從2開始做切片操作。
stringtags
刪除字符串中所有的html
標簽。示例代碼如下:
{{ value|striptags }}
如果value
是<strong>hello world</strong>
,那么以上代碼將會輸出hello world
。
truncatechars
如果給定的字符串長度超過了過濾器指定的長度。那么就會進行切割,並且會拼接三個點來作為省略號。示例代碼如下:
{{ value|truncatechars:5 }}
如果value
是等於北京歡迎您~,那么輸出的結果是北京...。可能你會想,為什么不會北京歡迎您...呢。因為三個點也占了三個字符,所以北京+三個點的字符長度就是5。
truncatechars_html
類似於truncatechars
,只不過是不會切割html
標簽。示例代碼如下:
{{ value|truncatechars:5 }}
如果value
是等於<p>北京歡迎您~</p>
,那么輸出將是<p>北京...</p>。