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,那麼隻會保留整數。當然也可以傳遞一個參數,標識具體要保留幾個小數。

如果沒有傳遞參數:

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

到此這篇關於Django 模板中常用的過濾器實現的文章就介紹到這瞭,更多相關Django 模板過濾器內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: