一财剖、變量

1. 變量的形式是：{{variable}}均唉， 當模板引擎碰到變量的時候隐孽，引擎使用變量的值代替變量癌椿。

2. 使用dot(.)能夠訪問變量的屬性

3. 當模板引擎碰到dot的時候，查找的順序是什么樣子呢菱阵？

   • 字典查找踢俄，例如：foo["var1"]
   • 屬性查找，例如：foo.bar
   • 方法查找送粱，例如：foo.bar()
     注意：方法查找比一般的查找要復雜一些
     (1)如果調用方法期間褪贵，方法拋出一個異常，那么異常將會產生，除非異常對象帶有一個屬性silent_variable_failure脆丁，
     如果這個值是True世舰，那么將會返回一個空字串。
     (2)方法調用僅僅對那些沒有參數(shù)的方法才會生效
     (3)一些方法會產生副作用槽卫，所以系統(tǒng)允許方法設置一個屬性alters_data跟压，如果值為True，那么將不能夠調用
     其設置方法是：
     def sensitive_function(self):
     #函數(shù)內容
     sensitive_function.alters_data = True
   • list-index查找歼培，例如foo[bar]

4. 如果模板中使用的某個變量不存在震蒋，那么模板系統(tǒng)將使用setting.py中 變量TEMPLATE_STRING_IF_INVALID的值進行替代，在默認情況下躲庄，該變量的值是''查剖。

二、過濾器

1. 可以通過過濾器來修改變量的顯示噪窘，過濾器的形式是：{{ variable | filter }}笋庄，管道符號'|'代表使用過濾器

2. 過濾器能夠采用鏈式的方式使用，例如：{{ text | escape | linebreaks }}

3. 過濾器還可以帶參數(shù)倔监，例如： {{ bio|truncatewords:30 }}

4. 過濾器的參數(shù)中如果帶有空格直砂，那么需要用引號引起來，例如：{{ list | join : ", "}}

5. django中30個內建的過濾器

   • add
     使用形式為：{{ value | add: "2"}}
     意義：將value的值增加2

   • addslashes
     使用形式為：{{ value | addslashes }}
     意義：在value中的引號前增加反斜線

   • capfirst
     使用形式為：{{ value | capfirst }}
     意義：value的第一個字符轉化成大寫形式

   • cut
     使用形式為：{{ value | cut:arg}}浩习， 例如静暂，如果value是“String with spaces” arg是" "那么輸出是"Stringwithspaces"
     意義：從給定value中刪除所有arg的值

   • date
     使用形式為：：
     (a) {{ value | date:"D d M Y" }}，例如谱秽，如果value是一個datetime對象(datetime.datetime.now())那么輸出將是字符串"Wed 09 Jan 2008"
     (b) {{ value | date }}洽蛀，這種形式沒有格式化字符串，這時候弯院，格式化字符串會自動采用DATE_FORMAT所設置的形式辱士。
     意義：將日期格式數(shù)據(jù)按照給定的格式輸出

   • default
     使用形式：{{ value | default: "nothing" }}，例如听绳，如果value是“”，那么輸出將是nothing
     意義：如果value的意義是False异赫，那么輸出使用缺省值

   • default_if_none
     使用形式：{{ value | default_if_none:"nothing" }}椅挣，例如，如果value是None塔拳，那么輸出將是nothing
     意義：如果value是None鼠证，那么輸出將使用缺省值

   • dictsort
     意義：如果value的值是一個字典，那么返回值是按照關鍵字排序的結果
     使用形式：{{ value | dictsort:"name"}}靠抑，例如量九，
     如果value是：
     [
     {'name': 'zed', 'age': 19},
     {'name': 'amy', 'age': 22},
     {'name': 'joe', 'age': 31},
     ]
     那么，輸出是：
     [
     {'name': 'amy', 'age': 22},
     {'name': 'joe', 'age': 31},
     {'name': 'zed', 'age': 19},
     ]

   • dictsortreversed
     意義：如果value的值是一個字典，那么返回值是按照關鍵字排序的結果的反序
     使用形式：與上述(8)完全相同荠列。

   • divisibleby
     使用形式：{{ value | divisibleby:arg}}类浪，如果value是21，arg是3肌似，那么輸出將是True
     意義：如果value能夠被arg整除费就，那么返回值將是True

   • escape
     使用形式：{{ value | escape}}
     意義：替換value中的某些字符，以適應HTML格式川队，包括：

     < is converted to &lt;
     > is converted to &gt;
     ' (single quote) is converted to &#39;
     " (double quote) is converted to &quot;
     & is converted to &amp;
     ```
     

   escape僅僅在輸出的時候才起作用力细，所以escape不能夠用在鏈式過濾器的中間，他應該總是最后一個過濾器固额，如果想在鏈式過濾器的中間使用眠蚂，那么可以使用force_escape

   • escapejs
     使用形式：{{ value | escapejs }}
     意義：替換value中的某些字符，以適應JAVASCRIPT和JSON格式斗躏。
   • filesizeformat
     使用形式：{{ value | filesizeformat }}
     意義：格式化value河狐，使其成為易讀的文件大小，例如：13KB瑟捣，4.1MB等馋艺。
   • first
     使用形式：{{ value | first }}
     意義：返回列表中的第一個Item，例如迈套，如果value是列表['a','b','c']捐祠，那么輸出將是'a'。
   • floatformat
     使用形式：{{ value | floatformat}}或者{{value|floatformat:arg}}桑李，
     arg可以是正數(shù)也可以是負數(shù)踱蛀。沒有參數(shù)的floatformat相當于floatformat:-1
     (1)如果不帶arg，那么引擎會四舍五入贵白，同時最多只保留一位小數(shù)率拒。
     34.23234 {{ value|floatformat }} 34.2
     34.00000 {{ value|floatformat }} 34
     34.26000 {{ value|floatformat }} 34.3
     (2)如果arg是正數(shù)，那么引擎會四舍五入禁荒，同時保留arg位的小數(shù)猬膨。
     34.23234 {{ value|floatformat:3 }} 34.232
     34.00000 {{ value|floatformat:3 }} 34.000
     34.26000 {{ value|floatformat:3 }} 34.260
     (3)如果arg是負數(shù)，那么引擎會四舍五入呛伴，如果有小數(shù)部分勃痴，那么保留arg位小數(shù)；否則热康，則沒有任何小數(shù)部分沛申。
     34.23234 {{ value|floatformat:"-3" }} 34.232
     34.00000 {{ value|floatformat:"-3" }} 34
     34.26000 {{ value|floatformat:"-3" }} 34.26
   • get_digit
     使用形式：{{ value | get_digit:"arg"}}，例如姐军，如果value是123456789铁材，arg是2尖淘，那么輸出是8
     意義：給定一個數(shù)字，返回著觉，請求的數(shù)字村生，記住：1代表最右邊的數(shù)字固惯，如果value不是合法輸入梆造，
     那么會返回所有原有值。
   • iriencode
     使用形式：{{value | iriencode}}
     意義：如果value中有非ASCII字符葬毫，那么將其進行抓化成URL中適合的編碼镇辉，如果value已經進行過URLENCODE，
     改操作就不會再起作用贴捡。
   • join
     使用形式：{{ value | join:"arg"}}忽肛，如果value是['a','b','c']，arg是'//'那么輸出是a//b//c
     意義：使用指定的字符串連接一個list烂斋，作用如同python的str.join(list)
   • last
     使用形式：{{ value | last }}
     意義：返回列表中的最后一個Item
   • length
     使用形式：{{ value | length }}
     意義：返回value的長度屹逛。
   • length_is
     使用形式：{{ value | length_is:"arg"}}
     意義：返回True，如果value的長度等于arg的時候汛骂，例如：如果value是['a','b','c']罕模，arg是3，那么返回True
   • linebreaks
     使用形式：{{value|linebreaks}}
     意義：value中的"\n"將被
     替代帘瞭，并且整個value使用</p>包圍起來淑掌，從而適和HTML的格式
   • linebreaksbr
     使用形式：{{value |linebreaksbr}}
     意義：value中的"\n"將被
     替代
   • linenumbers
     使用形式：{{value | linenumbers}}
     意義：顯示的文本，帶有行數(shù)蝶念。
   • ljust
     使用形式：{{value | ljust}}
     意義：在一個給定寬度的字段中抛腕，左對齊顯示value
   • center
     使用形式：{{value | center}}
     意義：在一個給定寬度的字段中，中心對齊顯示value
   • rjust
     使用形式：{{value | rjust}}
     意義：在一個給定寬度的字段中媒殉，右對齊顯示value
   • lower
     使用形式：{{value | lower}}
     意義：將一個字符串轉換成小寫形式
   • make_list
     使用形式：{{value | make_list}}
     意義：將value轉換成一個list担敌，對于字符串，轉換成字符list廷蓉；對于整數(shù)全封，轉換成整數(shù)list
     例如value是Joel，那么輸出將是[u'J',u'o',u'e',u'l']苦酱；value是123售貌，那么輸出將是[1,2,3]
   • pluralize
     使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}疫萤，或者{{value | pluralize:"y,ies"}}
     意義：如果value不是1，則返回一個復數(shù)后綴敢伸，缺省的后綴是's'
   • random
     使用形式：{{value | random}}
     意義：從給定的list中返回一個任意的Item
   • 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
   • safe
     使用形式：{{value | safe}}
     意義：當系統(tǒng)設置autoescaping打開的時候尾序，該過濾器使得輸出不進行escape轉換
   • safeseq
     與上述safe基本相同钓丰，但有一點不同的就是：safe是針對字符串，而safeseq是針對多個字符串組成的sequence
   • slice
     使用形式：{{some_list | slice:":2"}}
     意義：與python語法中的slice相同每币，:2表示第一的第二個元素
   • slugify
     使用形式：{{value | slugify}}
     意義：將value轉換成小寫形式携丁，同事刪除所有分單詞字符，并將空格變成橫線
     例如：如果value是Joel is a slug兰怠，那么輸出將是joel-is-a-slug
   • stringformat
     這個不經常用梦鉴，先不說
   • striptags
     使用形式：{{value | striptags}}
     意義：刪除value中的所有HTML標簽
   • time
     使用形式：{{value | time:"H:i"}}或者{{value | time}}
     意義：格式化時間輸出，如果time后面沒有格式化參數(shù)揭保，那么輸出按照TIME_FORMAT中設置的進行肥橙。
   • title
     轉換一個字符串成為title格式。
   • truncatewords
     使用形式：{{value | truncatewords:2}}
     意義：將value切成truncatewords指定的單詞數(shù)目
     例如秸侣，如果value是Joel is a slug 那么輸出將是：Joel is ...
   • truncatewords_html
     使用形式同(39)
     意義：truncation點之前如果某個標簽打開了存筏，但是沒有關閉，那么在truncation點會立即關閉味榛。
     因為這個操作的效率比truncatewords低椭坚，所有只有在value是html格式時，才考慮使用搏色。
   • upper
     轉換一個字符串為大寫形式
   • urlencode
     將一個字符串進行URLEncode
   • urlize
     意義：將一個字符串中的URL轉化成可點擊的形式善茎。
     使用形式：{{ value | urlize }}
     例如，如果value是Check out www.djangoproject.com继榆，那么輸出將是：
     Check out <a >www.djangoproject.com</a>
   • urlizetrunc
     使用形式：{{ value | urlizetrunc:15}}
     意義：與(43)相同巾表，但是有一點不同就是現(xiàn)實的鏈接字符會被truncate成特定的長度，后面以...現(xiàn)實略吨。
   • wordcount
     返回字符串中單詞的數(shù)目
   • wordwrap
     使用形式：{{value | wordwrap:5}}
     意義：按照指定的長度包裝字符串
     例如集币，如果value是Joel is a slug，那么輸出將會是：
     Joel
     is a
     slug
   • timesince
     使用形式：{{value | timesince:arg}}
     意義：返回參數(shù)arg到value的天數(shù)和小時數(shù)
     例如翠忠，如果 blog_date 是一個日期實例表示 2006-06-01 午夜鞠苟， 而 comment_date 是一個日期實例表示 2006-06-01 早上8點，
     那么 {{ comment_date|timesince:blog_date }} 將返回 "8 hours".
   • timeuntil
     使用形式：{{value | timeuntil}}
     意義：與timesince基本相同秽之，一個不同點就是当娱，返回的是value距離當前日期的天數(shù)和小時數(shù)。

三考榨、標簽

1. 標簽的形式是：{% tag %}跨细，標簽要比變量復雜
2. 標簽的作用
   • 在輸出時創(chuàng)建一些文本
   • 通過執(zhí)行循環(huán)和一些邏輯來實現(xiàn)控制流
   • 裝載一些外部信息進入模板
3. 內建標簽

   • autoescape
     使用形式：
     {% autoescape off %}
     (內容)
     {% endautoescape %}
     意義：當某塊內容不需要自動轉義的時候，這樣寫就可以了河质。當然如果塊內某些地方需要轉義的話冀惭，調用filter也可以震叙。

   • block
     使用形式：
     {% block %}
     (定義塊內容)
     {% endblock %}
     意義：定義一個塊，該塊能夠被繼承他的子孫模板重寫

   • comment
     使用形式：
     {% comment %}
     (內容)
     {% endcomment %}
     意義：模板系統(tǒng)會忽略該標簽內部的所有內容散休。

   • cycle
     使用形式：
     例如:
     <tr class="{% cycle list%}">
     ...
     </tr>
     意義：在循環(huán)時輪流使用給定的字符串列表中的值媒楼。

   • extends
     使用形式：{% extends "base.html" %}或者{% extends variable %}變量可以是一個字符串，也可以是一個模板對象戚丸。
     意義：表示本模板要對指定的父模板進行擴展划址。

   • filter
     使用形式：
     {%filter force_escape|lower%}
     (內容)
     {%endfilter%}
     意義：將filter 標簽圈定的內容執(zhí)行過濾器操作。

   • firstof
     使用形式：{%firstof var1 var2 var3%}
     意義：輸出第一個值不等于False的變量
     等價于：
     {% if var1 %}
     {{ var1 }}
     {% else %}
     {% if var2 %}
     {{ var2 }}
     {% else %}
     {% if var3 %}
     {{ var3 }}
     {% endif %}
     {% endif %}
     {% endif %}

   • for
     使用形式：
     {% for variable in list/dict %}
     (使用variable)
     {% endfor%}
     意義：循環(huán)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 當前的迭代器數(shù)目(從1開始)
     forloop.counter0 當前的迭代器數(shù)目(從0開始)
     forloop.revcounter 當前的反向迭代器數(shù)目(從1開始)
     forloop.revcounter0 當前的反向迭代器數(shù)目(從0開始)
     forloop.first 值為True夺颤，如果是第一次通過迭代器
     forloop.last 值為True，如果是最后一次通過迭代器
     forloop.parentloop 對于嵌套循環(huán)谣殊，這是當前循環(huán)的上一層循環(huán)

   • for ... empty
     使用形式如下：
     {% for varibale in list %}
     (內容1)
     {% empty %}
     (內容2)
     {% endfor %}
     意義：當list是空的時候拂共，能夠執(zhí)行內容2，其形式等同于姻几，先if判斷l(xiāng)ist是否存在宜狐，然后在根據(jù)情況做什么操作。

   • if
     使用形式如下 ：
     {% if variable %}
     (內容1)
     {% else %}
     (內容2)
     {% endif %}
     注意：variable中可以使用and or 或者not蛇捌，但是有一條必須記住抚恒，就是不允許and 和 or一起使用

   • ifchanged
     使用形式：
     (a)如果直接檢測循環(huán)變量是否變化，那么使用：
     {% ifchanged %}
     (內容)
     {% endifchanged %}
     (b)如果檢測循環(huán)變量的某個dot變量络拌，例如循環(huán)變量是date俭驮，那么檢測date.hour，那么使用：
     {% ifchanged date.hour%}
     (內容)
     {% endifchanged %}
     (c)ifchanged也可以加上一個{% else %}語句
     意義：檢測本次循環(huán)的值和上一次循環(huán)的值一樣不一樣春贸，只能用在循環(huán)里面混萝。

   • ifequal
     使用形式：
     {% ifequal variable1 variable2 %}
     ...
     {% endifequal %}
     意義：判斷兩個變量是否相等。

   • ifnotequal
     使用與(12)相同

   • include
     使用形式：{% include "foo/bar.html" %}或者{% include template_name %}
     意義：將另外一個模板文件中的內容添加到該文件中萍恕。注意區(qū)別extend是繼承逸嘀。

   • 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.
   

   • spaceless
     使用形式：{% spaceless %}
     (內容)
     {% endspaceless %}
     意義：刪除包圍內容中的所有tab或者回車字符崭倘。

   • template
     使用形式：{% templatetag %}
     意義：模板系統(tǒng)本身沒有轉義的概念，因此如果要輸出一個像“{%”這樣的東東类垫，就需要采用這種方式司光，否則就會語法錯誤
     其參數(shù)有：
     openblock {%
     closeblock %}
     openvariable {{
     closevariable }}
     openbrace {
     closebrace }
     opencomment {#
     closecomment #}

   • with
     使用形式：
     {% with "expensive var1" as var2 %}
     {% endwith %}
     意義：當一個變量的訪問消耗很大的模板解析時，可以用另外一個變量替換它悉患，這種替換只有在with內部有效残家。

   • url
     使用形式：{% url path.to.some_view arg1,arg2 %}
     意義：給定某個module中函數(shù)的名字，給定參數(shù)售躁，那么模板引擎給你一個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 %}