for
在每個(gè){% for %}
循環(huán)里有一個(gè)稱為forloop
的模板變量财搁。這個(gè)變量有一些提示循環(huán)進(jìn)度信息的屬性矗烛。
forloop.counter 總是一個(gè)表示當(dāng)前循環(huán)的執(zhí)行次數(shù)的整數(shù)計(jì)數(shù)器寨昙。 這個(gè)計(jì)數(shù)器是從1開(kāi)始的页慷,所以在第一次循環(huán)時(shí) forloop.counter 將會(huì)被設(shè)置為1察郁。
{% for item in todo_list %}
<p>{{ forloop.counter }}: {{ item }}</p>
{% endfor %}
forloop.counter0 類似于 forloop.counter 待逞,但是它是從0計(jì)數(shù)的。 第一次執(zhí)行循環(huán)時(shí)這個(gè)變量會(huì)被設(shè)置為0垦搬。
forloop.revcounter 是表示循環(huán)中剩余項(xiàng)的整型變量呼寸。 在循環(huán)初次執(zhí)行時(shí)forloop.revcounter 將被設(shè)置為序列中項(xiàng)的總數(shù)。 最后一次循環(huán)執(zhí)行中悼沿,這個(gè)變量將被置1等舔。
forloop.revcounter0 類似于 forloop.revcounter ,但它以0做為結(jié)束索引糟趾。 在第一次執(zhí)行循環(huán)時(shí)慌植,該變量會(huì)被置為序列的項(xiàng)的個(gè)數(shù)減1。
forloop.first是一個(gè)布爾值义郑,如果該迭代是第一次執(zhí)行蝶柿,那么它被置為True
在下面的情形中這個(gè)變量是很有用的:
{% for object in objects %}
{% if forloop.first %}<li class="first">{% else %}<li>{% endif %}
{{ object }}
</li>
{% endfor %}
forloop.last 是一個(gè)布爾值;在最后一次執(zhí)行循環(huán)時(shí)被置為True非驮。 一個(gè)常見(jiàn)的用法是在一系列的鏈接之間放置管道符(|)
{% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}
上面的模板可能會(huì)產(chǎn)生如下的結(jié)果:
Link1 | Link2 | Link3 | Link4
forloop.parentloop 是一個(gè)指向當(dāng)前循環(huán)的上一級(jí)循環(huán)的 forloop 對(duì)象的引用(在嵌套循環(huán)的情況下)交汤。 例子在此:
{% for country in countries %}
<table>
{% for city in country.city_list %}
<tr>
<td>Country #{{ forloop.parentloop.counter }}</td>
<td>City #{{ forloop.counter }}</td>
<td>{{ city }}</td>
</tr>
{% endfor %}
</table>
{% endfor %}
ifequal/ifnotequal
Django模板系統(tǒng)壓根兒就沒(méi)想過(guò)實(shí)現(xiàn)一個(gè)全功能的編程語(yǔ)言,所以它不允許我們?cè)谀0逯袌?zhí)行Python的語(yǔ)句(還是那句話劫笙,要了解更多請(qǐng)參看理念和限制小節(jié))芙扎。 但是比較兩個(gè)變量的值并且顯示一些結(jié)果實(shí)在是個(gè)太常見(jiàn)的需求了,所以Django提供了 {% ifequal %} 標(biāo)簽供我們使用填大。
{% ifequal %} 標(biāo)簽比較兩個(gè)值戒洼,當(dāng)他們相等時(shí),顯示在 {% ifequal %} 和 {% endifequal %} 之中所有的值允华。
{% ifequal %} 標(biāo)簽比較兩個(gè)值圈浇,當(dāng)他們相等時(shí)寥掐,顯示在 {% ifequal %} 和 {% endifequal %} 之中所有的值。
下面的例子比較兩個(gè)模板變量 user 和 currentuser :
{% ifequal user currentuser %}
<h1>Welcome!</h1>
{% endifequal %}
參數(shù)可以是硬編碼的字符串磷蜀,隨便用單引號(hào)或者雙引號(hào)引起來(lái)召耘,所以下列代碼都是正確的:
{% ifequal section 'sitenews' %}
<h1>Site News</h1>
{% endifequal %}
{% ifequal section "community" %}
<h1>Community</h1>
{% endifequal %}
和 {% if %} 類似, {% ifequal %} 支持可選的 {% else%} 標(biāo)簽:
{% ifequal section 'sitenews' %}
<h1>Site News</h1>
{% else %}
<h1>No News Here</h1>
{% endifequal %}
只有模板變量褐隆,字符串污它,整數(shù)和小數(shù)可以作為 {% ifequal %} 標(biāo)簽的參數(shù)。下面是合法參數(shù)的例子:
{% ifequal variable 1 %}
{% ifequal variable 1.23 %}
{% ifequal variable 'foo' %}
{% ifequal variable "foo" %}
其他任何類型庶弃,例如Python的字典類型轨蛤、列表類型、布爾類型虫埂,不能用在 {% ifequal %} 中。 下面是些錯(cuò)誤的例子:
{% ifequal variable True %}
{% ifequal variable [1, 2, 3] %}
{% ifequal variable {'key': 'value'} %}
過(guò)濾器
就象本章前面提到的一樣圃验,模板過(guò)濾器是在變量被顯示前修改它的值的一個(gè)簡(jiǎn)單方法掉伏。 過(guò)濾器使用管道字符,如下所示:
{{ name|lower }}
顯示的內(nèi)容是變量 {{ name }} 被過(guò)濾器 lower 處理后的結(jié)果澳窑,它功能是轉(zhuǎn)換文本為小寫(xiě)斧散。
過(guò)濾管道可以被* 套接* ,既是說(shuō)摊聋,一個(gè)過(guò)濾器管道的輸出又可以作為下一個(gè)管道的輸入鸡捐,如此下去。 下面的例子實(shí)現(xiàn)查找列表的第一個(gè)元素并將其轉(zhuǎn)化為大寫(xiě)麻裁。
{{ my_list|first|upper }}
有些過(guò)濾器有參數(shù)箍镜。 過(guò)濾器的參數(shù)跟隨冒號(hào)之后并且總是以雙引號(hào)包含。 例如:
{{ bio|truncatewords:"30" }}
以下幾個(gè)是最為重要的過(guò)濾器的一部分
date : 按指定的格式字符串參數(shù)格式化 date 或者 datetime 對(duì)象煎源, 范例:
{{ pub_date|date:"F j, Y" }}
length : 返回變量的長(zhǎng)度色迂。 對(duì)于列表,這個(gè)參數(shù)將返回列表元素的個(gè)數(shù)手销。 對(duì)于字符串歇僧,這個(gè)參數(shù)將返回字符串中字符的個(gè)數(shù)。 你可以對(duì)列表或者字符串锋拖,或者任何知道怎么測(cè)定長(zhǎng)度的Python 對(duì)象使用這個(gè)方法(也就是說(shuō)诈悍,有 len() 方法的對(duì)象)。