inclusions/_archives.html ... {% for date in date_list %} <li> <a href="{% url 'blog:archive' date.year date.month %}"> {{ date.year }} 年 {{ date.month }} 月 </a> </li> {% endfor %} ...
這里 {% url %}
這個模板標簽的作用是解析視圖函數 blog:archive
對應的 URL 模式,並把 URL 模式中的年和月替換成 date.year
,date.month
的值。
{% url %}
模板標簽接收的第一個參數為被解析視圖函數的端點值,這個端點值由 2 部分組成,中間由冒號分隔。第一部分為在應用的 urls.py 中指定的 app_name
的值(充當命名空間,這樣即使不同 app 下有相同的視圖函數名,也不會沖突),第二部分 path
函數中傳入的 name
參數的值。比如在 blog 應用的 urls.py 模塊,我們指定了 app_name = 'blog'
,archive
視圖函數的 url 模式為 path('archives/<int:year>/<int:month>/', views.archive, name='archive')
,因此對應的端點值為 blog:archive
。
{% url %}
模板標簽接收的其它參數為 URL 路徑參數,即 URL 模式中路徑參數轉換器需要捕獲的值。例如 archive
視圖函數對應的 URL 模式為 archives/<int:year>/<int:month>/
,假設 date.year=2017
,date.month=5
,那么 {% url 'blog:archive' date.year date.month %}
模板標簽返回的值為 /archives/2017/5/。
為什么要使用 {% url %} 模板標簽呢?事實上,我們把超鏈接的 href 屬性設置為 /archives/{{ date.year }}/{{ date.month }}/
同樣可以達到目的,但是這種寫法是硬編碼的。雖然現在 blog:archive
視圖函數對應的 URL 模式是這種形式,但是如果哪天這個模式改變了呢?如果使用了硬編碼的寫法,那你需要把每一處 /archives/{{ date.year }}/{{ date.month }}/
修改為新的模式。但如果使用了 {% url %} 模板標簽,則不用做任何修改。