首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Django 模板HTML中 变量 过滤器 标签 的使用方法

Django 模板HTML中 变量 过滤器 标签 的使用方法

作者头像
学到老
发布2019-01-25 11:32:01
3.9K0
发布2019-01-25 11:32:01
举报

最近在自学django,整理常用模块如下

一、变量 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 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是: [ {‘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.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”将被 替代,并且整个value使用

包围起来,从而适和HTML的格式 (23)linebreaksbr 使用形式:{{value |linebreaksbr}} 意义:value中的”\n”将被 替代 (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是Joel is a slug tags是”b span”,那么输出将是:Joel is 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 www.djangoproject.com (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 使用形式: 例如: … 意义:在循环时轮流使用给定的字符串列表中的值。

(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 %}
本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2018年08月15日,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档