目录

1.变量
2.过滤器
3.标签
4.分支
5.迭代器
6.自定义过滤器与标签
7.全系统过滤器（了解）

1.变量

1.视图函数可以通过两种方式将变量传递给模板页面
    -- render(request, 'test_page.html', {'变量key1': '变量值1', ..., '变量keyn': '变量值n'})
    -- render(request, 'test_page.html', locals())
        >>> locals() 就是将视图函数中的所有变量都传递给模板页面

2.模板页面中对变量的使用
    -- 语法：{{ 变量 }}
    -- 支持("全")类型：数字、字符串、布尔、列表、元组、字典、函数、对象、类
    -- 注：list.0 | dic.key | obj.name | obj.fn 来查看内部成员数据

3.补充:传递函数名和类名都会自动加括号调用(模板语法不支持额外的传参)

2.过滤器

1.语法：
    -- {{ 变量|过滤器1[[:参数]|...|过滤器n[:参数]] }}
    -- 注：过滤器可以串联操作，可以拥有0个或1个参数
    
2.常见内置filter
    -- 增加   add:num
    -- 字符串长度   length
    -- 默认值   default:'默认值'  # 变量不存在或为空
    -- 全大写   upper
    -- 全小写   lower
    -- 切片   slice:'0:-1'
    -- 将数字转换为文件大小   filesizeformat
    -- 字符串隐藏   truncatechars:13   # 只显示10个字符，后置字符都用...来替代
        --截取文本：truncatewords:3  #只显示三个单词，...不算字符
    -- 时间   date:'Y年-m月-d日'
    -- 转换原意   safe
    转义
    前端
        |safe
    后端
         from django.utils.safestring import mark_safe
         sss1 = mark_safe('<h2>老子要挣大钱</h2>')
         ps:前端代码也可以在后端写好传入!!!

3.标签

1.常见内置tag
"""
{{}}  变量相关
{%%}  逻辑相关
"""
  语法：
      -- {% 关键词 参数们 %}
    
  内置tag
    -- 反向解析url   {% url 'namespace:url_name' arg1 arg2 %}
    -- 当前时间now   {% now 'Y-m-d' %}
    -- 起别名with   {% with 'd.hobby.3.username' as name %} 
                               {{ name }}
                    {% endwith %}
    -- Django CSRF认证   {% csrf_token %}

4.分支

语法：
{% if 条件1 %}
    结论1
{% elif 条件2 %}
    结论2
{% else %}
    结论n
{% endif %}

注：
1. if的条件可以添加filter,last
2. 可以嵌套
# 案例
{% for foo in s %}
    {% if forloop.first %}
        <p>这是我的第一次~~</p>
    {% elif forloop.last %}
        <p>这是最后一次了啊~</p>
    {% else %}
        <p>{{ foo }}</p>
    {% endif %}
    
    {% empty %}
        <p>传入的数据是空的</p>
{% endfor %}

5.迭代器

{% for foo in iterate %}
    {{ forloop }}
{% empty %}
    可迭代对象为空
{% endfor %}

注：
1. iterate为可迭代对象
2. iterate可以添加filter
3. forloop变量为存放迭代信息的字典，父级forloop字典，开始索引从0编号或1编号，倒序索引从0编号或1编号，是否是第一次或最后一次循环
4. empty分支会在可迭代对象不存在或空时执行

6.自定义过滤器与标签

步骤：
1.在应用下创建一个名字必须叫"templatetags"文件夹
2.在上述文件夹内创建一个任意名称的py文件
3.在该py文件内固定先书写以下两句话
 from django import template
 register = template.Library()

4. 自定义过滤器
from django.template import Library
register = Library()
@register.filter(name='jump')
def owen_jump(value, arg):
    try:
        return value * int(arg)
    except (ValueError, TypeError):
        return ''
            
5. 自定义标签
@register.simple_tag(name='add_two')
def owen_add(arg1, arg2):
    try:
        return int(arg1) + int(arg2)
    except (ValueError, TypeError):
        try:
            return arg1 + arg2
        except Exception:
            return ''

6. 自定义inclusion_tag，login.hml页面for循环
@register.inclusion_tag('login.html',name='my_inclusion_tag')
def func2(n):
    l = []
    for i in range(1,n+1):
        l.append('第%s页'%i)
    return locals()
# login.html页面
<ul>
    {% for foo in l %}
      <li >{{foo}}</li>
    {%endfor%}
</ul> 
            
6. 在加载了自定义模块py文件的模板页面中使用，案例：
{{ 10|jump:2}}  # 10 * 2

{% add_two 10 20 %}  # 10 + 20

{% my_inclusion_tag 10 %} #html页数
{% my_inclusion_tag 8 %}  #html页数

inclusion_tag
    当某个区域需要反复使用并且数据不是固定的

7.全系统过滤器（了解）

{{ 123|add:"5" }} 给value加上一个数值
{{ "AB'CD"|addslashes }} 单引号加上转义号，一般用于输出到javascript中
{{ "abcd"|capfirst }} 第一个字母大写
{{ "abcd"|center:"50" }} 输出指定长度的字符串，并把值对中
{{ "123spam456spam789"|cut:"spam" }} 查找删除指定字符串
{{ value|date:"F j, Y" }} 格式化日期
{{ value|default:"(N/A)" }} 值不存在，使用指定值
{{ value|default_if_none:"(N/A)" }} 值是None，使用指定值
{{ 列表变量|dictsort:"数字" }} 排序从小到大
{{ 列表变量|dictsortreversed:"数字" }} 排序从大到小
{{ string|escape }} 转换为html实体
{{ 21984124|filesizeformat }} 以1024为基数，计算最大值，保留1位小数，增加可读性
{{ list|first }} 返回列表第一个元素
{{ "ik23hr&jqwh"|fix_ampersands }} &转为&
{{ 13.414121241|floatformat }} 保留1位小数，可为负数，几种形式
{{ 13.414121241|floatformat:"2" }} 保留2位小数
{{ 23456 |get_digit:"1" }} 从个位数开始截取指定位置的1个数字
{{ list|join:", " }} 用指定分隔符连接列表
{{ list|length }} 返回列表个数
{% if 列表|length_is:"3" %} 列表个数是否指定数值
{{ "ABCD"|linebreaks }} 用新行用
{{ "ABCD"|linebreaksbr }} 用新行用 标记包裹
{{ 变量|linenumbers }} 为变量中每一行加上行号
{{ "abcd"|ljust:"50" }} 把字符串在指定宽度中对左，其它用空格填充
{{ "ABCD"|lower }} 小写
{{ "abcdefghijklmnopqrstuvwxyz"|phone2numeric }} 把字符转为可以对应的数字？？
{{ 列表或数字|pluralize }} 单词的复数形式，如列表字符串个数大于1，返回s，否则返回空串
{{ 列表或数字|pluralize:"es" }} 指定es
{{ 列表或数字|pluralize:"y,ies" }} 指定ies替换为y
{{ object|pprint }} 显示一个对象的值
{{ 列表|random }} 返回列表的随机一项
{{ string|removetags:"br p div" }} 删除字符串中指定html标记
{{ string|rjust:"50" }} 把字符串在指定宽度中对右，其它用空格填充
{{ 列表|slice:":2" }} 切片
{{ string|slugify }} 字符串中留下减号和下划线，其它符号删除，空格用减号替换
{{ 3|stringformat:"02i" }} 字符串格式，使用Python的字符串格式语法
{{ "EABCD"|striptags }} 剥去[X]HTML语法标记
{{ 时间变量|time:"P" }} 日期的时间部分格式
{{ datetime|timesince }} 给定日期到现在过去了多少时间
{{ datetime|timesince:"other_datetime" }} 两日期间过去了多少时间
{{ datetime|timeuntil }} 给定日期到现在过去了多少时间，与上面的区别在于2日期的前后位置。
{{ datetime|timeuntil:"other_datetime" }} 两日期间过去了多少时间
{{ "abdsadf"|title }} 首字母大写
{{ "A B C D E F"|truncatewords:"3" }} 截取指定个数的单词
{{ "111221"|truncatewords_html:"2" }} 截取指定个数的html标记，并补完整
{{ list|unordered_list }} 多重嵌套列表展现为html的无序列表
{{ string|upper }} 全部大写
{{ string|urlize }} 将URLs由纯文本变为可点击的链接。（没有实验成功）
{{ string|urlizetrunc:"30" }} 同上，多个截取字符数。（同样没有实验成功）
{{ "B C D E F"|wordcount }} 单词数
{{ "a b c d e f g h i j k"|wordwrap:"5" }} 每指定数量的字符就插入回车符
{{ boolean|yesno:"Yes,No,Perhaps" }} 对三种值的返回字符串，对应是 非空,空,None