詳解Django自定義過濾器

木子昭發表於2017-10-13
Django過濾器
過濾器與函式

django過濾器的本質是函式,但”函式”太多了,為了顯示自己的與眾不同,設計者們想了個名字”過濾器”…

django有一些內建的過濾器,但和”新手賽車”不多(把字母轉成小寫,求陣列長度,從陣列中取一個隨機值),功能很基礎(不夠強大)…

抱著一種”研究琢磨”的心態,試著自己動手寫一個過濾器:功能很簡單,求一個陣列中的最大值(今天太晚了,偷個懶哈~)

功能是很簡單的:

過濾器

先給出我的一點體會:

在django是MVP的架構,資料模型交給Model,邏輯處理交給View,樣式模板交給temPlate,這是公認的合理架構.

隨著專案規模的增大，會出現一些問題,view掌管了所有的邏輯處理,一些很基礎的邏輯功能(比如求最大值,最小值,給使用者名稱加個字首)是沒必要與核心邏輯放在一起的,不僅讓程式碼顯得冗餘,而且也影響核心模組的迭代維護…

所以django的設計者,決定把一些很基礎通用的邏輯模組單獨取出,放到app目錄下的templatetags資料夾內(資料夾名字不可改,否則會django會無法識別),templatetags可以存放多個檔案,每個檔案可以存放多個功能相關的過濾器,使用功能相關的過濾器時,直接匯入單個檔案就可以一併使用相關功能,不愧是django,框架設計真的很贊!

具體使用規則:

1.如果對某個app下的網頁使用過濾器,則在對應app的根目錄下,建立名為templatetags的資料夾(這裡的pad為一個獨立的app)

新建目錄

2.在templatetags資料夾下,新建空檔案__init__.py(這是python的規矩,__init__.py表示其所在的資料夾是一個可以載入的模組,__init__檔案內容可為空),新建檔案zhao_filter.py(這個檔案可以存放多個過濾器,檔名字可自定義…)

新建檔案

3.在my_filter.py中,先匯入標頭檔案,編寫過濾器函式(這裡偷個懶,直接用python的內建函式做示範),註冊過濾器(還是喜歡裝飾器);

from django.template import Library

# 將註冊類例項化為register物件
register =  Library()


# 使用裝飾器註冊
@register.filter
def get_list_max(val):
    # val為一個列表,通過過濾器取得其中的最大值
    result = max(val)

    return result

4.將過濾器載入到html, 使用自定義的過濾器


<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>過濾器</title>
</head>
<body>

{# 載入過濾器所在的檔案,由於templatetags的檔名是固定的,django可以直接找到過濾器檔案所在的位置 #}
{% load zhao_fillter %}


{# 顯示列表資料 #}
列表的資料為:{{ my_list }}

<hr>

{# 使用自定義的過濾器get_list_max,獲得列表中最大的值 #}
列表中的最大值為:{{ my_list | get_list_max }}

</body>
</html>

有時候測試伺服器會抽風，找不到過濾器，此時刪除__init__.py，再重新建立__init__.py即可！


相關文章