Django模板语言

MVC框架
MVC，全名是Model View Controller，是软件工程中的一种软件架构模式，把软件系统分为三个基本部分：模型(Model)、视图(View)和控制器(Controller)，
具有耦合性低、重用性高、生命周期成本低等优点。

MTV框架
Django框架的设计模式借鉴了MVC框架的思想，也是分成三部分，来降低各个部分之间的耦合性。
Django框架的不同之处在于它拆分的三部分为：Model（模型）、Template（模板）和View（视图），也就是MTV框架。
Model(模型)：负责业务对象与数据库的对象(ORM)
Template(模版)：负责如何把页面展示给用户
View(视图)：负责业务逻辑，并在适当的时候调用Model和Template

命令行创建APP
    python manage.py startapp app01
pycharm创建APP
    Tools-->Run manage.py Task...-->startapp app01

常用语法
    变量相关的用{{}}，逻辑相关的用{%%}

变量
Django的模板语言中按此语法使用：{{ 变量名 }}
变量的命名包括任何字母数字以及下划线 ("_")的组合。 变量名称中不能有空格或标点符号。
点（.）在模板语言中有特殊的含义。当模版系统遇到点(".")，它将以这样的顺序查询：
    字典查询（Dictionary lookup）
    属性或方法查询（Attribute or method lookup）
    数字索引查询（Numeric index lookup）
模板中支持的写法：
    {# 取l中的第一个参数 #}    {{ l.0 }}
    {# 取字典中key的值 #}    {{ d.name }}
    {# 取对象的name属性 #}    {{ person_list.0.name }}
    {# .操作只能调用不带参数的方法 #}    {{ person_list.0.dream }}

filter(过滤器)
Django的模板语言中，通过使用 过滤器 来改变变量的显示。

过滤器的语法： {{ value|filter_name:参数 }}

使用管道符"|"来应用过滤器。
例如：{{ name|lower }}会将name变量应用lower过滤器之后再显示它的值。lower在这里的作用是将文本全都变成小写

注意事项：
    过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
    过滤器可以接受参数，例如：{{ sss|truncatewords:30 }}，这将显示sss的前30个词。
    过滤器参数包含空格的话，必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素，如：{{ list|join:', ' }}
    '|'左右没有空格没有空格没有空格

default
如果一个变量是false或者为空，使用给定的默认值。 否则，使用变量的值。
{{ value|default:"nothing"}}
如果value没有传值或者值为空的话就显示nothing

length
返回值的长度，作用于字符串和列表。
{{ value|length }}
返回value的长度，如 value=['a', 'b', 'c', 'd']的话，就显示4

filesizeformat
将值格式化为一个 “人类可读的” 文件尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等）。
{{ value|filesizeformat }}
如果 value 是 123456789，输出将会是 117.7 MB。

slice
切片
{{value|slice:"2:-1"}}

date
格式化
{{ value|date:"Y-m-d H:i:s"}}

safe
Django的模板中会对HTML标签和JS等语法标签进行自动转义，原因显而易见，这样是为了安全，为了在Django中关闭HTML的自动转义，如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。
value = "<a href='#'>点我</a>"
{{ value|safe}}

truncatechars(根据字符，多用于中文，...也算三个字符)
如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾。
参数：截断的字符数
{{ value|truncatechars:9}
truncatewords(以空格截断，多用于英文)
在一定数量的字后截断字符串。
{{ value|truncatewords:9}}

cut
移除value中所有的与给出的变量相同的字符串
{{ value|cut:' ' }}
如果cut:'a'，那么将移除所有的'a'

join
使用字符串连接列表，如Python的str.join(list)

timesince
将日期格式设为自该日期起的时间（例如，“4天，6小时”）。
采用一个可选参数，它是一个包含用作比较点的日期的变量（不带参数，比较点为现在）。
{{ blog_date|timesince:comment_date }}
分钟是所使用的最小单位，对于相对于比较点的未来的任何日期，将返回“0分钟”。

timeuntil
似于timesince，除了它测量从现在开始直到给定日期或日期时间的时间。
例如，如果今天是2018年11月1日，而conference_date是保留2018年11月29日的日期实例，则{{ conference_date | timeuntil }}将返回“4周”。
{{ conference_date|timeuntil:from_date }}

自定义filter
自定义filter的步骤
    在app下面新建一个python package名字叫templatetags
    在上一步的python package中新建一个py文件
    在py文件中写一个函数，实现自定义的filter功能
    告诉Django我现在多了一个自定义的filter
使用自定义的filter
    在HTML文件中导入刚才创建的py文件
    重启Django项目
    按照普通的filter调用自定义的函数

格式化字符    描述    示例输出
a    'a.m.'或'p.m.'（请注意，这与PHP的输出略有不同，因为这包括符合Associated Press风格的期间）    'a.m.'
A    'AM'或'PM'。    'AM'
b    月，文字，3个字母，小写。    'jan'
B    未实现。     
c    ISO 8601格式。 （注意：与其他格式化程序不同，例如“Z”，“O”或“r”，如果值为naive datetime，则“c”格式化程序不会添加时区偏移量（请参阅datetime.tzinfo） 。    2008-01-02T10:30:00.000123+02:00或2008-01-02T10:30:00.000123如果datetime是天真的
d    月的日子，带前导零的2位数字。    '01'到'31'
D    一周中的文字，3个字母。    “星期五”
e    时区名称 可能是任何格式，或者可能返回一个空字符串，具体取决于datetime。    ''、'GMT'、'-500'、'US/Eastern'等
E    月份，特定地区的替代表示通常用于长日期表示。    'listopada'（对于波兰语区域，而不是'Listopad'）
f    时间，在12小时的小时和分钟内，如果它们为零，则分钟停留。 专有扩展。    '1'，'1:30'
F    月，文，长。    '一月'
g    小时，12小时格式，无前导零。    '1'到'12'
G    小时，24小时格式，无前导零。    '0'到'23'
h    小时，12小时格式。    '01'到'12'
H    小时，24小时格式。    '00'到'23'
i    分钟。    '00'到'59'
I    夏令时间，无论是否生效。    '1'或'0'
j    没有前导零的月份的日子。    '1'到'31'
l    星期几，文字长。    '星期五'
L    布尔值是否是一个闰年。    True或False
m    月，2位数字带前导零。    '01'到'12'
M    月，文字，3个字母。    “扬”
n    月无前导零。    '1'到'12'
N    美联社风格的月份缩写。 专有扩展。    'Jan.'，'Feb.'，'March'，'May'
o    ISO-8601周编号，对应于使用闰年的ISO-8601周数（W）。 对于更常见的年份格式，请参见Y。    '1999年'
O    与格林威治时间的差异在几小时内。    '+0200'
P    时间为12小时，分钟和'a.m。'/'p.m。'，如果为零，分钟停留，特殊情况下的字符串“午夜”和“中午”。 专有扩展。    '1 am'，'1:30 pm' / t3>，'midnight'，'noon'，'12：30 pm' / T10>
r    RFC 5322格式化日期。    'Thu, 21 Dec 2000 16:01:07 +0200'
s    秒，带前导零的2位数字。    '00'到'59'
S    一个月的英文序数后缀，2个字符。    'st'，'nd'，'rd'或'th'
t    给定月份的天数。    28 to 31
T    本机的时区。    'EST'，'MDT'
u    微秒。    000000 to 999999
U    自Unix Epoch以来的二分之一（1970年1月1日00:00:00 UTC）。     
w    星期几，数字无前导零。    '0'（星期日）至'6'（星期六）
W    ISO-8601周数，周数从星期一开始。    1，53
y    年份，2位数字。    '99'
Y    年，4位数。    '1999年'
z    一年中的日子    0到365
Z    时区偏移量，单位为秒。 UTC以西时区的偏移量总是为负数，对于UTC以东时，它们总是为正。    -43200到43200

自定义filter代码文件摆放位置：
app01/
    __init__.py
    models.py
    templatetags/  # 在app01下面新建一个package package
        __init__.py
        app01_filters.py  # 建一个存放自定义filter的文件
    views.py

编写自定义filter:
from django import template
register = template.Library()

@register.filter(name="cut")
def cut(value, arg):
    return value.replace(arg, "")

@register.filter(name="addSB")
def add_sb(value):
    return "{} SB".format(value)

使用自定义filter
{# 先导入我们自定义filter那个文件 #}
{% load app01_filters %}

{# 使用我们自定义的filter #}
{{ somevariable|cut:"0" }}
{{ d.name|addSB }}

Tags
for
<ul>
{% for user in user_list %}
    <li>{{ user.name }}</li>
{% endfor %}
</ul>

for循环可用的一些参数：
forloop.counter-->当前循环的索引值（从1开始）
forloop.counter0-->当前循环的索引值（从0开始）
forloop.revcounter-->当前循环的倒序索引值（从1开始）
forloop.revcounter0-->当前循环的倒序索引值（从0开始）
forloop.first-->当前循环是不是第一次循环（布尔值）
forloop.last-->当前循环是不是最后一次循环（布尔值）
forloop.parentloop-->本层循环的外层循环

for ... empty
<ul>
{% for user in user_list %}
    <li>{{ user.name }}</li>
{% empty %}
    <li>空空如也</li>
{% endfor %}
</ul>

if,elif和else
{% if user_list %}
  用户人数：{{ user_list|length }}
{% elif black_list %}
  黑名单数：{{ black_list|length }}
{% else %}
  没有用户
{% endif %}

当然也可以只有if和else
{% if user_list|length > 5 %}
  七座豪华SUV
{% else %}
    黄包车
{% endif %}
if语句支持 and 、or、==、>、<、!=、<=、>=、in、not in、is、is not判断。

with
定义一个中间变量
{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

csrf_token
这个标签用于跨站请求伪造保护。
在页面的form表单里面写上{% csrf_token %}

注释
{# ... #}

注意事项
Django的模板语言不支持连续判断，即不支持以下写法：
{% if a > b > c %}
...
{% endif %}

Django的模板语言中属性的优先级大于方法