django 內置標籤和過濾器
1、變量
1.變量的形式是：{{variable}}， 當模板引擎碰到變量的時候，引擎使用變量的值代替變量。
2.使用dot(.)可以訪問變量的屬性
3.當模板引擎碰到dot的時候，查找的順序是什麼樣子呢？
a.字典查找，例如：foo["var1"]
b.屬性查找，例如：foo.bar
c.方法查找，例如：foo.bar()
d.list-index查找，例如foo[bar]
html
注意：方法查找比通常的查找要複雜一些 (1)若是調用方法期間，方法拋出一個異常，那麼異常將會產生，除非異常對象帶有一個屬性silent_variable_failure， 若是這個值是True，那麼將會返回一個空字串。 (2)方法調用僅僅對那些沒有參數的方法纔會生效 (3)一些方法會產生反作用，因此係統容許方法設置一個屬性alters_data，若是值爲True，那麼將不可以調用 其設置方法是： def sensitive_function(self): #函數內容 sensitive_function.alters_data = True
4.若是模板中使用的某個變量不存在，那麼模板系統將使用setting.py中 變量TEMPLATE_STRING_IF_INVALID的值進行替代，在默認狀況下，該變量的值是''。
2、過濾器
1.能夠經過過濾器來修改變量的顯示，過濾器的形式是：{{ variable | filter }}，管道符號'|'表明使用過濾器
2.過濾器可以採用鏈式的方式使用，例如：{{ text | escape | linebreaks }}
3.過濾器還能夠帶參數，例如： {{ bio|truncatewords:30 }}
4.過濾器的參數中若是帶有空格，那麼須要用引號引發來，例如：{{ list | join : ", "}}
5.django中30個內建的過濾器
(1)add
使用形式爲：{{ value | add: "2"}}
意義：將value的值增長2
(2)addslashes
使用形式爲：{{ value | addslashes }}
意義：在value中的引號前增長反斜線
(3)capfirst
使用形式爲：{{ value | capfirst }}
意義：value的第一個字符轉化成大寫形式
(4)cut
使用形式爲：{{ value | cut:arg}}， 例如，若是value是「String with spaces」 arg是" "那麼輸出是"Stringwithspaces"
意義：從給定value中刪除全部arg的值
(5)date
使用形式爲：：
(a) {{ value | date:"D d M Y" }}，例如，若是value是一個datetime對象(datetime.datetime.now())那麼輸出將是字符串"Wed 09 Jan 2008"
(b) {{ value | date }}，這種形式沒有格式化字符串，這時候，格式化字符串會自動採用DATE_FORMAT所設置的形式。
意義：將日期格式數據按照給定的格式輸出
(6)default
使用形式：{{ value | default: "nothing" }}，例如，若是value是「」，那麼輸出將是nothing
意義：若是value的意義是False，那麼輸出使用缺省值
(7)default_if_none
使用形式：{{ value | default_if_none:"nothing" }}，例如，若是value是None，那麼輸出將是nothing
意義：若是value是None，那麼輸出將使用缺省值
(8)dictsort
意義：若是value的值是一個字典，那麼返回值是按照關鍵字排序的結果
使用形式：{{ value | dictsort:"name"}}，例如，
若是value是：python
[ {'name': 'zed', 'age': 19}, {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, ] 那麼，輸出是： [ {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, {'name': 'zed', 'age': 19}, ] (9)dictsortreversed
意義：若是value的值是一個字典，那麼返回值是按照關鍵字排序的結果的反序
使用形式：與上述(8)徹底相同。
(10)divisibleby
使用形式：{{ value | divisibleby:arg}}，若是value是21，arg是3，那麼輸出將是True
意義：若是value可以被arg整除，那麼返回值將是True
(11)escape
使用形式：{{ value | escape}}
意義：替換value中的某些字符，以適應HTML格式，包括： < is converted to < > is converted to > ' (single quote) is converted to ' " (double quote) is converted to " & is converted to &
escape僅僅在輸出的時候才起做用，因此escape不可以用在鏈式過濾器的中間，
他應該老是最後一個過濾器，若是想在鏈式過濾器的中間使用，那麼可使用force_escape
(12)escapejs
使用形式：{{ value | escapejs }}
意義：替換value中的某些字符，以適應JAVASCRIPT和JSON格式。
(13)filesizeformat
使用形式：{{ value | filesizeformat }}
意義：格式化value，使其成爲易讀的文件大小，例如：13KB，4.1MB等。
(14)first
使用形式：{{ value | first }}
意義：返回列表中的第一個Item，例如，若是value是列表['a','b','c']，那麼輸出將是'a'。
(15)floatformat
使用形式：{{ value | floatformat}}或者{{value|floatformat:arg}}，
arg能夠是正數也能夠是負數。沒有參數的floatformat至關於floatformat:-1
(1)若是不帶arg，那麼引擎會四捨五入，同時最多隻保留一位小數。
| 34.23234 | {{ value|floatformat }} | 34.2 |
| 34.00000 | {{ value|floatformat }} | 34 |
| 34.26000 | {{ value|floatformat }} | 34.3 |
(2)若是arg是正數，那麼引擎會四捨五入，同時保留arg位的小數。
| 34.23234 | {{ value|floatformat:3 }} | 34.232 |
| 34.00000 | {{ value|floatformat:3 }} | 34.000 |
| 34.26000 | {{ value|floatformat:3 }} | 34.260 |
(3)若是arg是負數，那麼引擎會四捨五入，若是有小數部分，那麼保留arg位小數；不然，則沒有任何小數部分。
| 34.23234 | {{ value|floatformat:"-3" }} | 34.232 |
| 34.00000 | {{ value|floatformat:"-3" }} | 34 |
| 34.26000 | {{ value|floatformat:"-3" }} | 34.26 |
(16)get_digit
使用形式：{{ value | get_digit:"arg"}}，例如，若是value是123456789，arg是2，那麼輸出是8
意義：給定一個數字，返回，請求的數字，記住：1表明最右邊的數字，若是value不是合法輸入，
那麼會返回全部原有值。
(17)iriencode 使用形式：{{value | iriencode}}
意義：若是value中有非ASCII字符，那麼將其進行抓化成URL中適合的編碼，若是value已經進行過URLENCODE，
改操做就不會再起做用。
(18)join
使用形式：{{ value | join:"arg"}}，若是value是['a','b','c']，arg是'//'那麼輸出是a//b//c
意義：使用指定的字符串鏈接一個list，做用如同python的str.join(list)
(19)last
使用形式：{{ value | last }}
意義：返回列表中的最後一個Item
(20)length
使用形式：{{ value | length }}
意義：返回value的長度。
(21)length_is
使用形式：{{ value | length_is:"arg"}}
意義：返回True，若是value的長度等於arg的時候，例如：若是value是['a','b','c']，arg是3，那麼返回True
(22)linebreaks
使用形式：{{value|linebreaks}}
意義：value中的"\n"將被<br/>替代，而且整個value使用</p>包圍起來，從而適和HTML的格式
(23)linebreaksbr
使用形式：{{value |linebreaksbr}}
意義：value中的"\n"將被<br/>替代
(24)linenumbers
使用形式：{{value | linenumbers}}
意義：顯示的文本，帶有行數。
(25)ljust
使用形式：{{value | ljust}}
意義：在一個給定寬度的字段中，左對齊顯示value (25)center
使用形式：{{value | center}}
意義：在一個給定寬度的字段中，中心對齊顯示value (25)rjust
使用形式：{{value | rjust}}
意義：在一個給定寬度的字段中，右對齊顯示value (26)lower
使用形式：{{value | lower}}
意義：將一個字符串轉換成小寫形式
(27)make_list
使用形式：{{value | make_list}}
意義：將value轉換成一個list，對於字符串，轉換成字符list；對於整數，轉換成整數list
例如value是Joel，那麼輸出將是[u'J',u'o',u'e',u'l']；value是123，那麼輸出將是[1,2,3]
(28)pluralize
使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}，或者{{value | pluralize:"y,ies"}}
意義：若是value不是1，則返回一個複數後綴，缺省的後綴是's'
(29)random
使用形式：{{value | random}}
意義：從給定的list中返回一個任意的Item
(30)removetags
使用形式：{{value | removetags:"tag1 tag2 tag3..."}}
意義：刪除value中tag1,tag2....的標籤。例如，若是value是<b>Joel</b> <button>is</button> a <span>slug</span>
tags是"b span"，那麼輸出將是：Joel <button>is</button> a slug
(31)safe
使用形式：{{value | safe}}
意義：當系統設置autoescaping打開的時候，該過濾器使得輸出不進行escape轉換
(32)safeseq
與上述safe基本相同，但有一點不一樣的就是：safe是針對字符串，而safeseq是針對多個字符串組成的sequence
(33)slice
使用形式：{{some_list | slice:":2"}}
意義：與python語法中的slice相同，:2表示第一的第二個元素
(34)slugify
使用形式：{{value | slugify}}
意義：將value轉換成小寫形式，同事刪除全部分單詞字符，並將空格變成橫線
例如：若是value是Joel is a slug，那麼輸出將是joel-is-a-slug
(35)stringformat
這個不常常用，先不說
(36)striptags
使用形式：{{value | striptags}}
意義：刪除value中的全部HTML標籤
(37)time
使用形式：{{value | time:"H:i"}}或者{{value | time}}
意義：格式化時間輸出，若是time後面沒有格式化參數，那麼輸出按照TIME_FORMAT中設置的進行。
(38)title
轉換一個字符串成爲title格式。
(39)truncatewords
使用形式：{{value | truncatewords:2}}
意義：將value切成truncatewords指定的單詞數目
例如，若是value是Joel is a slug 那麼輸出將是：Joel is ...
(40)truncatewords_html
使用形式同(39)
意義：truncation點以前若是某個標籤打開了，可是沒有關閉，那麼在truncation點會當即關閉。
由於這個操做的效率比truncatewords低，全部只有在value是html格式時，才考慮使用。
(41)upper
轉換一個字符串爲大寫形式
(42)urlencode
將一個字符串進行URLEncode
(43)urlize
意義：將一個字符串中的URL轉化成可點擊的形式。
使用形式：{{ value | urlize }}
例如，若是value是Check out www.djangoproject.com，那麼輸出將是： Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a>
(44)urlizetrunc
使用形式：{{ value | urlizetrunc:15}}
意義：與(43)相同，可是有一點不一樣就是現實的連接字符會被truncate成特定的長度，後面以...現實。
(45)wordcount
返回字符串中單詞的數目
(46)wordwrap
使用形式：{{value | wordwrap:5}}
意義：按照指定的長度包裝字符串
例如，若是value是Joel is a slug，那麼輸出將會是：
Joel
is a
slug
(47)timesince
使用形式：{{value | timesince:arg}}
意義：返回參數arg到value的天數和小時數
例如，若是 blog_date 是一個日期實例表示 2006-06-01 午夜， 而 comment_date 是一個日期實例表示 2006-06-01 早上8點，
那麼 {{ comment_date|timesince:blog_date }} 將返回 "8 hours".
(48)timeuntil
使用形式：{{value | timeuntil}}
意義：與(47)基本相同，一個不一樣點就是，返回的是value距離當前日期的天數和小時數。
3、標籤
1.標籤的形式是：{% tag %}，標籤要比變量複雜
2.標籤的做用
(1)在輸出時建立一些文本
(2)經過執行循環和一些邏輯來實現控制流
(3)裝載一些外部信息進入模板
3.內建標籤
(1)autoescape
使用形式：
{% autoescape off %}
(內容)
{% endautoescape %}
意義：當某塊內容不須要自動轉義的時候，這樣寫就能夠了。固然若是塊內某些地方須要轉義的話，調用filter也能夠。
(2)block
使用形式：
{% block %}
(定義塊內容)
{% endblock %}
意義：定義一個塊，該塊可以被繼承他的子孫模板重寫
(3)comment
使用形式：
{% comment %}
(內容)
{% endcomment %}
意義：模板系統會忽略該標籤內部的全部內容。
(4)cycle
使用形式：
例如:
<tr class="{% cycle list%}">
...
</tr>
意義：在循環時輪流使用給定的字符串列表中的值。
(5)extends
使用形式：{% extends "base.html" %}或者{% extends variable %}變量能夠是一個字符串，也能夠是一個模板對象。
意義：表示本模板要對指定的父模板進行擴展。
(6)filter
使用形式：
{%filter force_escape|lower%}
(內容)
{%endfilter%}
意義：將filter 標籤圈定的內容執行過濾器操做。
(7)firstof
使用形式：{%firstof var1 var2 var3%}
意義：輸出第一個值不等於False的變量
等價於： {% if var1 %} {{ var1 }} {% else %}
{% if var2 %} {{ var2 }} {% else %}
{% if var3 %} {{ var3 }} {% endif %}
{% endif %}
{% endif %}
(8)for
使用形式：
{% for variable in list/dict %}
(使用variable)
{% endfor%}
意義：循環list中的每一個值，進行相應的輸出
注意：(a)也能夠反向遍歷{% for variable in list/dict reversed %}
(b)也能夠{% for x, y in points %} points中的每一個元素爲 (x,y)
(c)也能夠{% for key,value in data.items %} data是一個dictionary
for loop中定義的一些內建變量
forloop.counter 當前的迭代器數目(從1開始) forloop.counter0 當前的迭代器數目(從0開始) forloop.revcounter 當前的反向迭代器數目(從1開始) forloop.revcounter0 當前的反向迭代器數目(從0開始) forloop.first 值爲True，若是是第一次經過迭代器 forloop.last 值爲True，若是是最後一次經過迭代器
forloop.parentloop 對於嵌套循環，這是當前循環的上一層循環 (9)for ... empty
使用形式以下：
{% for varibale in list %}
(內容1)
{% empty %}
(內容2)
{% endfor %}
意義：當list是空的時候，可以執行內容2，其形式等同於，先if判斷list是否存在，而後在根據狀況作什麼操做。
(10)if
使用形式以下 ：
{% if variable %}
(內容1)
{% else %}
(內容2)
{% endif %}
注意：variable中可使用and or 或者not，可是有一條必須記住，就是不容許and 和 or一塊兒使用
(11)ifchanged
使用形式：
(a)若是直接檢測循環變量是否變化，那麼使用：
{% ifchanged %}
(內容)
{% endifchanged %}
(b)若是檢測循環變量的某個dot變量，例如循環變量是date，那麼檢測date.hour，那麼使用： {% ifchanged date.hour%}
(內容)
{% endifchanged %}
(c)ifchanged也能夠加上一個{% else %}語句
意義：檢測本次循環的值和上一次循環的值同樣不同，只能用在循環裏面。
(12)ifequal
使用形式：
{% ifequal variable1 variable2 %}
...
{% endifequal %}
意義：判斷兩個變量是否相等。
(13)ifnotequal
使用與(12)相同
(14)include
使用形式：{% include "foo/bar.html" %}或者{% include template_name %}
意義：將另一個模板文件中的內容添加到該文件中。注意區別extend是繼承。
(15)now
使用形式：{% now "jS F Y H:i "%}，注意存在須要轉義的狀況例如{% now "jS o\f F" %}，由於f是格式化字符串
具體的格式化字符串以下所示
| a | 'a.m.' or 'p.m.' (Note that this is slightly different than PHP's output, because this includes periods to match Associated Press style.) | 'a.m.' |
| A | 'AM' or 'PM'. | 'AM' |
| b | Month, textual, 3 letters, lowercase. | 'jan' |
| B | Not implemented. | |
| d | Day of the month, 2 digits with leading zeros. | '01' to '31' |
| D | Day of the week, textual, 3 letters. | 'Fri' |
| f | Time, in 12-hour hours and minutes, with minutes left off if they're zero. Proprietary extension. | '1', '1:30' |
| F | Month, textual, long. | 'January' |
| g | Hour, 12-hour format without leading zeros. | '1' to '12' |
| G | Hour, 24-hour format without leading zeros. | '0' to '23' |
| h | Hour, 12-hour format. | '01' to '12' |
| H | Hour, 24-hour format. | '00' to '23' |
| i | Minutes. | '00' to '59' |
| I | Not implemented. | |
| j | Day of the month without leading zeros. | '1' to '31' |
| l | Day of the week, textual, long. | 'Friday' |
| L | Boolean for whether it's a leap year. | True or False |
| m | Month, 2 digits with leading zeros. | '01' to '12' |
| M | Month, textual, 3 letters. | 'Jan' |
| n | Month without leading zeros. | '1' to '12' |
| N | Month abbreviation in Associated Press style. Proprietary extension. | 'Jan.', 'Feb.', 'March', 'May' |
| O | Difference to Greenwich time in hours. | '+0200' |
| P | Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off if they're zero and the special-case strings 'midnight' and 'noon' if appropriate. Proprietary extension. | '1 a.m.', '1:30 p.m.', 'midnight','noon', '12:30 p.m.' |
| r | RFC 2822 formatted date. | 'Thu, 21 Dec 2000 16:01:07+0200' |
| s | Seconds, 2 digits with leading zeros. | '00' to '59' |
| S | English ordinal suffix for day of the month, 2 characters. | 'st', 'nd', 'rd' or 'th' |
| t | Number of days in the given month. | 28 to 31 |
| T | Time zone of this machine. | 'EST', 'MDT' |
| U | Not implemented. | |
| w | Day of the week, digits without leading zeros. | '0' (Sunday) to '6' (Saturday) |
| W | ISO-8601 week number of year, with weeks starting on Monday. | 1, 53 |
| y | Year, 2 digits. | '99' |
| Y | Year, 4 digits. | '1999' |
| z | Day of the year. | 0 to 365 |
| Z | Time zone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. |
(16)spaceless
使用形式：{% spaceless %}
(內容)
{% endspaceless %}
意義：刪除包圍內容中的全部tab或者回車字符。
(17)template
使用形式：{% templatetag %}
意義：模板系統自己沒有轉義的概念，所以若是要輸出一個像「{%」這樣的東東，就須要採用這種方式，不然就會語法錯誤
其參數有：
| openblock | {% |
| closeblock | %} |
| openvariable | {{ |
| closevariable | }} |
| openbrace | { |
| closebrace | } |
| opencomment | {# |
| closecomment | #} |
(18)with
使用形式：
{% with "expensive var1" as var2 %}
{% endwith %}
意義：當一個變量的訪問消耗很大的模板解析時，能夠用另一個變量替換它，這種替換隻有在with內部有效。
(19)url
使用形式：{% url path.to.some_view arg1,arg2 %}
意義：給定某個module中函數的名字，給定參數，那麼模板引擎給你一個URL，從而避免硬編碼URL到代碼中
注意：前提是URLconf中存在相應的映射,若是URLconf中沒有該映射，那麼會拋出異常，
這是能夠選擇使用
{% url path.to.view arg1 ,arg2 as the url %} <a href="{{ the_url }}">Link to optional stuff</a> 其實這至關於 {% url path.to.view as the_url %} {% if the_url %} <a href="{{ the_url }}">Link to optional stuff</a> {% endif %}
相關文章
- 1. Django 標籤過濾器
- 2. Django 2.1.3 文檔-模板-內置標籤和過濾器(tag&filter)
- 3. django特殊的標籤和過濾器
- 4. 自定義Django過濾器標籤
- 5. Django過濾器與自定義標籤
- 6. django1.5 自定義過濾器和標籤
- 7. Django1.3 模板標籤和過濾器
- 8. django模板-if標籤、for標籤、自定義標籤和過濾器
- 9. django 內置標籤
- 10. django神器 <自定義過濾器filter 和 標籤tag>
- 更多相關文章...
- • PHP 過濾器 - PHP教程
- • PHP FILTER_CALLBACK 過濾器 - PHP參考手冊
- • IntelliJ IDEA 代碼格式化配置和快捷鍵
- • Docker容器實戰(七) - 容器眼光下的文件系統
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
歡迎關注本站公眾號,獲取更多信息
