# 第四節:常用過濾器
# 模版常用過濾器
在模版中,有時候需要對一些數據進行處理以后才能使用。一般在`Python`中我們是通過函數的形式來完成的。而在模版中,則是通過過濾器來實現的。過濾器使用的是`|`來使用。比如使用`add`過濾器,那么示例代碼如下:
```
<pre class="calibre12">```
{{ value|add:<span class="hljs-string">"2"</span> }}
```
```
那么以下就講下在開發中常用的過濾器。
### add
將傳進來的參數添加到原來的值上面。這個過濾器會嘗試將`值`和`參數`轉換成整形然后進行相加。如果轉換成整形過程中失敗了,那么會將`值`和`參數`進行拼接。如果是字符串,那么會拼接成字符串,如果是列表,那么會拼接成一個列表。示例代碼如下:
```
<pre class="calibre12">```
{{ value|add:<span class="hljs-string">"2"</span> }}
```
```
如果`value`是等于4,那么結果將是6。如果`value`是等于一個普通的字符串,比如`abc`,那么結果將是`abc2`。`add`過濾器的源代碼如下:
```
<pre class="calibre12">```
<span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">add</span><span class="hljs-params">(value, arg)</span>:</span>
<span class="hljs-string">"""Add the arg to the value."""</span>
<span class="hljs-keyword">try</span>:
<span class="hljs-keyword">return</span> int(value) + int(arg)
<span class="hljs-keyword">except</span> (ValueError, TypeError):
<span class="hljs-keyword">try</span>:
<span class="hljs-keyword">return</span> value + arg
<span class="hljs-keyword">except</span> Exception:
<span class="hljs-keyword">return</span> <span class="hljs-string">''</span>
```
```
### cut
移除值中所有指定的字符串。類似于`python`中的`replace(args,"")`。示例代碼如下:
```
<pre class="calibre12">```
{{ value|cut:<span class="hljs-string">" "</span> }}
```
```
以上示例將會移除`value`中所有的空格字符。`cut`過濾器的源代碼如下:
```
<pre class="calibre12">```
<span class="hljs-function"><span class="hljs-keyword">def</span> <span class="hljs-title">cut</span><span class="hljs-params">(value, arg)</span>:</span>
<span class="hljs-string">"""Remove all values of arg from the given string."""</span>
safe = isinstance(value, SafeData)
value = value.replace(arg, <span class="hljs-string">''</span>)
<span class="hljs-keyword">if</span> safe <span class="hljs-keyword">and</span> arg != <span class="hljs-string">';'</span>:
<span class="hljs-keyword">return</span> mark_safe(value)
<span class="hljs-keyword">return</span> value
```
```
### date
將一個日期按照指定的格式,格式化成字符串。示例代碼如下:
```
<pre class="calibre12">```
<span class="hljs-title"># 數據</span>
context = {
<span class="hljs-string">"birthday"</span>: datetime.now()
}
<span class="hljs-title"># 模版</span>
{{ birthday|date:<span class="hljs-string">"Y/m/d"</span> }}
```
```
那么將會輸出`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:<span class="hljs-string">"nothing"</span> }}
```
```
如果`value`是等于一個空的字符串。比如`""`,那么以上代碼將會輸出`nothing`。
### default\_if\_none
如果值是`None`,那么將會使用`default_if_none`提供的默認值。這個和`default`有區別,`default`是所有被評估為`False`的都會使用默認值。而`default_if_none`則只有這個值是等于`None`的時候才會使用默認值。示例代碼如下:
```
<pre class="calibre12">```
{{ value|default_if_none:<span class="hljs-string">"nothing"</span> }}
```
```
如果`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:<span class="hljs-string">"/"</span> }}
```
```
如果`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:<span class="hljs-string">"2:"</span> }}
```
```
以上代碼將會給`some_list`從`2`開始做切片操作。
### stringtags
刪除字符串中所有的`html`標簽。示例代碼如下:
```
<pre class="calibre12">```
{{ value|striptags }}
```
```
如果`value`是`<strong>hello world</strong>`,那么以上代碼將會輸出`hello world`。
### truncatechars
如果給定的字符串長度超過了過濾器指定的長度。那么就會進行切割,并且會拼接三個點來作為省略號。示例代碼如下:
```
<pre class="calibre12">```
{{ value|truncatechars:<span class="hljs-params">5</span> }}
```
```
如果`value`是等于`北京歡迎您~`,那么輸出的結果是`北京...`。可能你會想,為什么不會`北京歡迎您...`呢。因為三個點也占了三個字符,所以`北京`+三個點的字符長度就是5。
### truncatechars\_html
類似于`truncatechars`,只不過是不會切割`html`標簽。示例代碼如下:
```
<pre class="calibre12">```
{{ value|truncatechars:<span class="hljs-params">5</span> }}
```
```
如果`value`是等于`<p>北京歡迎您~</p>`,那么輸出將是`<p>北京...</p>`。
- Introduction
- 第一章:學前準備
- 第一節:虛擬環境
- 第二節:準備工作
- 第三節:Django介紹
- 第四節:URL組成部分
- 第二章:URL與視圖
- 第一節:第一個Django項目
- 第二節:視圖與URL分發器
- 第三章:模板
- 第一節:模板介紹
- 第二節:模板變量
- 第三節:常用標簽
- 第四節:常用過濾器
- 第五節:自定義過濾器
- 第七節:模版結構優化
- 第八節:加載靜態文件
- 第四章:數據庫
- 第一節:MySQL相關軟件
- 第二節:數據庫操作
- 第三節:ORM模型
- 第四節:模型常用字段
- 第五節:外鍵和表關系
- 第六節:增刪改查操作
- 第七節:查詢操作
- 第八節:QuerySet API
- 第九節:ORM模型遷移
- 第十節:ORM作業
- 第十一節:ORM作業參考答案
- 第十二節:Pycharm連接數據庫
- 第五章:視圖高級
- 第一節:限制請求method
- 第二節:頁面重定向
- 第三節:HttpRequest對象
- 第四節:HttpResponse對象
- 第五節:生成CSV文件
- 第六節:類視圖
- 第七節:錯誤處理
- 第六章:表單
- 第一節:表單概述
- 第二節:用表單驗證數據
- 第三節:ModelForm
- 第四節:文件上傳
- 第七章:cookie和session
- 第八章:上下文處理器和中間件
- 第一節:上下文處理器
- 第二節:中間件
- 第九章:安全
- 第一節:CSRF攻擊
- 第二節:XSS攻擊
- 第三節:點擊劫持攻擊
- 第四節:SQL注入
- 第十章:信號
- 第一節:什么是信號
- 第十一章:驗證和授權
- 第一節:概述
- 第二節:用戶對象
- 第三節:權限和分組
- 第十二章:Admin系統
- 第十三章:Django的緩存
- 第十四章:memcached
- 第十五章:Redis