第四節：常用過濾器 · Python Djiango文檔

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