不管是寫(xiě)自定義標(biāo)簽還是過(guò)濾器，第一件要做的事是創(chuàng)建模板庫(kù)（Django能夠?qū)氲幕窘Y(jié)構(gòu)）。

創(chuàng)建一個(gè)模板庫(kù)分兩步走：

    第一，決定模板庫(kù)應(yīng)該放在哪個(gè)Django應(yīng)用下。 如果你通過(guò) manage.py startapp 創(chuàng)建了一個(gè)應(yīng)用，你可以把它放在那里，或者你可以為模板庫(kù)單獨(dú)創(chuàng)建一個(gè)應(yīng)用。 我們更推薦使用后者，因?yàn)槟愕膄ilter可能在后來(lái)的工程中有用。

    無(wú)論你采用何種方式，請(qǐng)確保把你的應(yīng)用添加到 INSTALLED_APPS 中。 我們稍后會(huì)解釋這一點(diǎn)。

    第二，在適當(dāng)?shù)腄jango應(yīng)用包里創(chuàng)建一個(gè) templatetags 目錄。 這個(gè)目錄應(yīng)當(dāng)和 models.py 、 views.py 等處于同一層次。 例如：

books/
  __init__.py
  models.py
  templatetags/
  views.py

    在 templatetags 中創(chuàng)建兩個(gè)空文件： 一個(gè) __init__.py （告訴Python這是 一個(gè)包含了Python代碼的包）和一個(gè)用來(lái)存放你自定義的標(biāo)簽/過(guò)濾器定義的文件。 第二個(gè)文件的名字稍后將用來(lái)加載標(biāo)簽。 例如，如果你的自定義標(biāo)簽/過(guò)濾器在一個(gè)叫作 poll_extras.py 的文件中，你需要在模板中寫(xiě)入如下內(nèi)容：

{% load poll_extras %}

    {% load %} 標(biāo)簽檢查 INSTALLED_APPS 中的設(shè)置，僅允許加載已安裝的Django應(yīng)用程序中的模板庫(kù)。 這是一個(gè)安全特性；它可以讓你在一臺(tái)電腦上部署很多的模板庫(kù)的代碼，而又不用把它們暴露給每一個(gè)Django安裝。

如果你寫(xiě)了一個(gè)不和任何特定模型/視圖關(guān)聯(lián)的模板庫(kù)，那么得到一個(gè)僅包含 templatetags 包的Django應(yīng)用程序包是完全正常的。 對(duì)于在 templatetags 包中放置多少個(gè)模塊沒(méi)有做任何的限制。 需要了解的是：{%load%}語(yǔ)句是通過(guò)指定的Python模塊名而不是應(yīng)用名來(lái)加載標(biāo)簽/過(guò)濾器的。

一旦創(chuàng)建了Python模塊，你只需根據(jù)是要編寫(xiě)過(guò)濾器還是標(biāo)簽來(lái)相應(yīng)的編寫(xiě)一些Python代碼。

作為合法的標(biāo)簽庫(kù)，模塊需要包含一個(gè)名為register的模塊級(jí)變量。這個(gè)變量是template.Library的實(shí)例，是所有注冊(cè)標(biāo)簽和過(guò)濾器的數(shù)據(jù)結(jié)構(gòu)。 所以，請(qǐng)?jiān)谀愕哪K的頂部插入如下語(yǔ)句：

from django import template

register = template.Library()

注意

請(qǐng)閱讀Django默認(rèn)的過(guò)濾器和標(biāo)簽的源碼，那里有大量的例子。 他們分別為： django/template/defaultfilters.py 和 django/template/defaulttags.py 。django.contrib中的某些應(yīng)用程序也包含模板庫(kù)。

創(chuàng)建 register 變量后，你就可以使用它來(lái)創(chuàng)建模板的過(guò)濾器和標(biāo)簽了。

最新評(píng)論