Django（31）模板中常用的過濾器

Silent丿丶黑羽發表於2021-05-24
Django過濾器

模版常用過濾器

在模版中，有時候需要對一些資料進行處理以後才能使用。一般在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，那麼只會保留整數。當然也可以傳遞一個引數，標識具體要保留幾個小數。

  1. 如果沒有傳遞引數：
value 模版程式碼 輸出
34.23234 {{ value|floatformat }} 34.2
34.000 {{ value|floatformat }} 34
34.260 {{ value|floatformat }} 34.3
  1. 如果傳遞引數：
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>。

相關文章