第三節：常用標簽 · Python Djiango文檔

# 第三節：常用標簽 # 常用的模板標簽： 1. `if`標簽：`if`標簽相當于`Python`中的`if`語句，有`elif`和`else`相對應，但是所有的標簽都需要用標簽符號（`{%%}`）進行包裹。`if`標簽中可以使用`==、!=、<、<=、>、>=、in、not in、is、is not`等判斷運算符。示例代碼如下： ``` <pre class="calibre12">``` {% if "張三" in persons %} 張三 {% else %} 李四 {% endif %} ``` ``` 2. `for...in...`標簽：`for...in...`類似于`Python`中的`for...in...`。可以遍歷列表、元組、字符串、字典等一切可以遍歷的對象。示例代碼如下： ``` <pre class="calibre12">``` {% for person in persons %} {{ person.name }} {% endfor %} ``` ``` 如果想要反向遍歷，那么在遍歷的時候就加上一個`reversed`。示例代碼如下： ``` <pre class="calibre12">``` {% for person in persons reversed %} {{ person.name }} {% endfor %} ``` ``` 遍歷字典的時候，需要使用`items`、`keys`和`values`等方法。在`DTL`中，執行一個方法不能使用圓括號的形式。遍歷字典示例代碼如下： ``` <pre class="calibre12">``` {% for key,value in person.items %} key：{{ key }} value：{{ value }} {% endfor %} ``` ``` 在`for`循環中，`DTL`提供了一些變量可供使用。這些變量如下： - `forloop.counter`：當前循環的下標。以1作為起始值。 - `forloop.counter0`：當前循環的下標。以0作為起始值。 - `forloop.revcounter`：當前循環的反向下標值。比如列表有5個元素，那么第一次遍歷這個屬性是等于5，第二次是4，以此類推。并且是以1作為最后一個元素的下標。 - `forloop.revcounter0`：類似于forloop.revcounter。不同的是最后一個元素的下標是從0開始。 - `forloop.first`：是否是第一次遍歷。 - `forloop.last`：是否是最后一次遍歷。 - `forloop.parentloop`：如果有多個循環嵌套，那么這個屬性代表的是上一級的for循環。 3. `for...in...empty`標簽：這個標簽使用跟`for...in...`是一樣的，只不過是在遍歷的對象如果沒有元素的情況下，會執行`empty`中的內容。示例代碼如下： ``` <pre class="calibre12">``` {% for person in persons %} <li>{{ person }}</li> {% empty %} 暫時還沒有任何人 {% endfor %} ``` ``` 4. `with`標簽：在模版中定義變量。有時候一個變量訪問的時候比較復雜，那么可以先把這個復雜的變量緩存到一個變量上，以后就可以直接使用這個變量就可以了。示例代碼如下： ``` <pre class="calibre12">``` context = { "persons": ["張三","李四"] } {% with lisi=persons.1 %} {{ lisi }} {% endwith %} ``` ``` 有幾點需要強烈的注意： - 在`with`語句中定義的變量，只能在`{%with%}{%endwith%}`中使用，不能在這個標簽外面使用。 - 定義變量的時候，不能在等號左右兩邊留有空格。比如`{% with lisi = persons.1%}`是錯誤的。 - 還有另外一種寫法同樣也是支持的：``` <pre class="calibre12">``` {% with persons.1 as lisi %} {{ lisi }} {% endwith %} ``` ``` 5. `url`標簽：在模版中，我們經常要寫一些`url`，比如某個`a`標簽中需要定義`href`屬性。當然如果通過硬編碼的方式直接將這個`url`寫死在里面也是可以的。但是這樣對于以后項目維護可能不是一件好事。因此建議使用這種反轉的方式來實現，類似于`django`中的`reverse`一樣。示例代碼如下： ``` <pre class="calibre12">``` <a href="{% url 'book:list' %}">圖書列表頁面</a> ``` ``` 如果`url`反轉的時候需要傳遞參數，那么可以在后面傳遞。但是參數分位置參數和關鍵字參數。位置參數和關鍵字參數不能同時使用。示例代碼如下： ``` <pre class="calibre12">``` # path部分 path('detail/<book_id>/',views.book_detail,name='detail') # url反轉，使用位置參數 <a href="{% url 'book:detail' 1 %}">圖書詳情頁面</a> # url反轉，使用關鍵字參數 <a href="{% url 'book:detail' book_id=1 %}">圖書詳情頁面</a> ``` ``` 如果想要在使用`url`標簽反轉的時候要傳遞查詢字符串的參數，那么必須要手動在在后面添加。示例代碼如下： ``` <pre class="calibre12">``` <a href="{% url 'book:detail' book_id=1 %}?page=1">圖書詳情頁面</a> ``` ``` 如果需要傳遞多個參數，那么通過空格的方式進行分隔。示例代碼如下： ``` <pre class="calibre12">``` <a href="{% url 'book:detail' book_id=1 page=2 %}">圖書詳情頁面</a> ``` ``` 6. `spaceless`標簽：移除html標簽中的空白字符。包括空格、tab鍵、換行等。示例代碼如下： ``` <pre class="calibre12">``` {% spaceless %} <a href="foo/">Foo</a> {% endspaceless %} ``` ``` 那么在渲染完成后，會變成以下的代碼： ``` <pre class="calibre12">``` <p><a href="foo/">Foo</a></p> ``` ``` `spaceless`只會移除html標簽之間的空白字符。而不會移除標簽與文本之間的空白字符。看以下代碼： ``` <pre class="calibre12">``` {% spaceless %} Hello {% endspaceless %} ``` ``` 這個將不會移除`strong`中的空白字符。 7. `autoescape`標簽：開啟和關閉這個標簽內元素的自動轉義功能。自動轉義是可以將一些特殊的字符。比如`<`轉義成`html`語法能識別的字符，比如`<`會被轉義成`<`，而`>`會被自動轉義成`>`。模板中默認是已經開啟了自動轉義的。`autoescape`的示例代碼如下： ``` <pre class="calibre12">``` # 傳遞的上下文信息 context = { "info":"<a href='www.baidu.com'>百度</a>" } # 模板中關閉自動轉義 {% autoescape on %} {{ info }} {% endautoescape %} ``` ``` 那么就會顯示百度的一個超鏈接。如果把`on`成`off`，那么就會顯示成一個普通的字符串。示例代碼如下： ``` <pre class="calibre12">``` {% autoescape on %} {{ info }} {% endautoescape %} ``` ``` 8. `verbatim`標簽：默認在`DTL`模板中是會去解析那些特殊字符的。比如`{%`和`%}`以及`{{`等。如果你在某個代碼片段中不想使用`DTL`的解析引擎。那么你可以把這個代碼片段放在`verbatim`標簽中。示例代碼下： ``` <pre class="calibre12">``` {% verbatim %} {{if dying}}Still alive.{{/if}} {% endverbatim %} ``` ``` 9. 更多標簽請參考官方文檔：`https://docs.djangoproject.com/en/2.0/ref/templates/builtins/`