django模板使用心得

来源:互联网 发布:数控车床锥度编程实例 编辑:程序博客网 时间:2024/03/29 18:38
一、变量 
 
   1.变量的形式是:{{variable}}, 当模板引擎碰到变量的时候,引擎使用变量的值代替变量。
   2.使用dot(.)能够访问变量的属性
   3.当模板引擎碰到dot的时候,查找的顺序是什么样子呢?
       a.字典查找,例如:foo["var1"]
       b.属性查找,例如:foo.bar
       c.方法查找,例如:foo.bar()
       d.list-index查找,例如foo[bar]
注意:方法查找比一般的查找要复杂一些     (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的值进行替代,在默认情况下,该变量的值是''。

二、过滤器
   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 09Jan 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是:
       [           {'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 &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    (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.234.00000{{value|floatformat }}3434.26000{{value|floatformat }}34.3
(2)如果arg是正数,那么引擎会四舍五入,同时保留arg位的小数。
34.23234{{value|floatformat:3 }}34.23234.00000{{value|floatformat:3 }}34.00034.26000{{value|floatformat:3 }}34.260
(3)如果arg是负数,那么引擎会四舍五入,如果有小数部分,那么保留arg位小数;否则,则没有任何小数部分。
34.23234{{value|floatformat:"-3" }}34.23234.00000{{value|floatformat:"-3" }}3434.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距离当前日期的天数和小时数。三、标签    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 thatthis is slightly different than PHP's output, because this includesperiods to match Associated Press style.)'a.m.'A'AM'or 'PM'.'AM'bMonth, textual, 3 letters, lowercase.'jan'BNot implemented. dDay of the month, 2 digits with leading zeros.'01'to '31'DDay of the week, textual, 3 letters.'Fri'fTime, in 12-hour hours and minutes, with minutes left off ifthey're zero. Proprietary extension.'1','1:30'FMonth, textual, long.'January'gHour, 12-hour format without leading zeros.'1'to '12'GHour, 24-hour format without leading zeros.'0'to '23'hHour, 12-hour format.'01'to '12'HHour, 24-hour format.'00'to '23'iMinutes.'00'to '59'INot implemented. jDay of the month without leading zeros.'1'to '31'lDay of the week, textual, long.'Friday'LBoolean for whether it's a leap year.True or FalsemMonth, 2 digits with leading zeros.'01'to '12'MMonth, textual, 3 letters.'Jan'nMonth without leading zeros.'1'to '12'NMonth abbreviation in Associated Press style. Proprietaryextension.'Jan.', 'Feb.', 'March','May'ODifference to Greenwich time in hours.'+0200'PTime, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutesleft off if they're zero and the special-case strings 'midnight'and 'noon' if appropriate. Proprietary extension.'1a.m.', '1:30 p.m.','midnight', 'noon', '12:30p.m.'rRFC 2822 formatted date.'Thu,21 Dec2000 16:01:07+0200'sSeconds, 2 digits with leading zeros.'00'to '59'SEnglish ordinal suffix for day of the month, 2 characters.'st', 'nd', 'rd' or'th'tNumber of days in the given month.28to 31TTime zone of this machine.'EST', 'MDT'UNot implemented. wDay of the week, digits without leading zeros.'0'(Sunday) to '6' (Saturday)WISO-8601 week number of year, with weeks starting onMonday.1,53yYear, 2 digits.'99'YYear, 4 digits.'1999'zDay of the year.0 to365ZTime zone offset in seconds. The offset for timezones west ofUTC is always negative, and for those east of UTC is alwayspositive.
(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 %}
0 0
原创粉丝点击