django框架模板

模板

• 模板介绍
  • 模板
    • 目前市面上有非常多的模板系统，其中最知名最好用的就是DTL和Jinja2。DTL是Django Template Language三个单词的缩写，也就是Django自带的模板语言。当然也可以配置Django支持Jinja2等其他模板引擎，但是作为Django内置的模板语言，和Django可以达到无缝衔接而不会产生一些不兼容的情况。
  • DTL与普通的HTML文件的区别
    • DTL模板是一种带有特殊语法的HTML文件，这个HTML文件可以被Django编译，可以传递参数进去，实现数据动态化。在编译完成后，生成一个普通的HTML文件，然后发送给客户端。
  • 渲染模板
    • render_to_string
      • 找到模板，然后将模板编译后渲染成Python的字符串格式。最后再通过HttpResponse类包装成一个HttpResponse对象返回回去。
        from django.template.loader import render_to_string from django.http import HttpResponse def book_detail(request,book_id): html = render_to_string("detail.html") return HttpResponse(html)​
    • render
      • 将模板渲染成字符串和包装成HttpResponse对象一步到位完成。
        from django.shortcuts import render def book_list(request): return render(request,'list.html')
  • 模板查找路径配置
    在项目的settings.py文件中。有一个TEMPLATES配置，这个配置包含了模板引擎的配置，模板查找路径的配置，模板上下文的配置等。模板路径可以在两个地方配置。
    • DIRS
      • 这是一个列表，在这个列表中可以存放所有的模板路径，以后在视图中使用render或者render_to_string渲染模板的时候，会在这个列表的路径中查找模板。
    • APP_DIRS
      • 默认为True，这个设置为True后，会在INSTALLED_APPS的安装了的APP下的templates文件加中查找模板。
      • 优先级
        • DIRS>APP
        • 没有抛出一个TemplateDoesNotExist的异常。
• 模板变量
  • 变量
    • 模板中可以包含变量，
      • Django在渲染模板的时候，可以传递变量对应的值过去进行替换。
      • 变量的命名规范和Python非常类似
        • 只能是阿拉伯数字和英文字符以及下划线的组合，不能出现标点符号等特殊字符。
      • 变量需要通过视图函数渲染，视图函数在使用render或者render_to_string的时候可以传递一个context的参数
        • 这个参数是一个字典类型。以后在模板中的变量就从这个字典中读取值的
          profile.html模板代码<p>{{ username }}</p># views.py代码def profile(request): return render(request,'profile.html',context={'username':'huangyong'})
    • 模板中的变量同样也支持点(.)的形式。
      不能通过中括号的形式访问字典和列表中的值，比如dict['key']和list[1]是不支持的！
      • 字典
        • 查找这个字典的username这个key对应的值。
      • 对象
        • 查找这个对象的username属性，或者是username这个方法。
      • .1
        • 一个列表或者元组或者任意的可以通过下标访问的对象，如果是的话就取这个列表的第1个值。
        • 如果不是就获取到的是一个空的字符串。
• 模板标签
  • if
    • if相当于python中的if语句
    • 使用方法
      • {%if%}
      • {%else%}
      • {%endif%}
    • 判断运算符
      • ==、!=、<、<=、>、>=、in、not in、is、is not等
  • for
    • 相当于python中的for循环
    • 使用方法
      • {%for %}
      • {%endfor%}
      • 快捷键
        • for Tab
      • 如果要反向遍历在最后加reverrsed
    • DTL变量
      • forloop.counter
        • 当前循环的下标。以1作为起始值。
      • forloop.counter0
        • 当前循环的下标。以0作为起始值。
      • forloop.revcounter
        • 当前循环的反向下标值，以1作为最后一个元素的下标。
      • forloop.revcounter0
        • 当前循环的反向下标值，以0作为最后一个元素的下标。
      • forloop.first
        • 是否是第一次遍历。
      • forloop.last
        • 是否是最后一次遍历
  • empty
    • 在没有值得情况下
      • 返回empty后的提示语
  • with
    • 模板中定义变量
    • 使用方法
      • {% with lisi=persons.1 %} 或 {% with persons.1 as lisi %}
      • {% endwith %}
  • url
    • 模板中url写法
    • 使用方法
      • {% url 'name'%}
      • 传参
        • {% url 'name' xxx=1%}
• 过滤器
  • 在模板中对数据进行处理使用
    • {{ value|filter_name:'str'}}
    • 不能有空格
  • 常用过滤器
    • add
      • 将值和参数转换成整形然后进行相加。
    • cut
      • 移除值中所有指定的字符串。
    • date
      • 将一个日期按照指定的格式，格式化成字符串。
      • 时间格式化格式
        • Y
          • 四位数字的年份
        • m
          • 两位数字的月份
        • n
          • 月份，1-9前面没有0前缀
        • d
          • 两位数字的天
        • j
          • 天，但是1-9前面没有0前缀
        • g
          • 小时，12小时格式的，1-9前面没有0前缀
        • h
          • 小时，12小时格式的，1-9前面有0前缀
        • G
          • 小时，24小时格式的，1-9前面没有0前缀
        • H
          • 小时，24小时格式的，1-9前面有0前缀
        • i
          • 分钟，1-9前面有0前缀
        • s
          • 秒，1-9前面有0前缀
    • default
      • 如果值被评估为False。
        • 使用default过滤器提供的默认值。
    • default_if_none
      • 如果值是None
        • 使用default_if_none提供的默认值。
        • 只有这个值是等于None的时候才会使用默认值。
    • first
      • 返回列表/元组/字符串中的第一个元素。
    • last
      • 返回列表/元组/字符串中的最后一个元素。
    • floatformat
      • 使用四舍五入的方式格式化一个浮点类型。
        • 如果没有传递参数
          • 在小数点后保留一个小数
        • 如果传递参数
          • 就保留几位
    • join
      • 将列表/元组/字符串用指定的字符进行拼接
    • length
      • 获取一个列表/元组/字符串/字典的长度
    • lower
      • 将值中所有的字符全部转换成小写
    • upper
      • 将值中所有的字符全部转换成大写
    • random
      • 在被给的列表/字符串/元组中随机的选择一个值
    • safe
      • 标记一个字符串是安全的。也即会关掉这个字符串的自动转义
    • slice
      • 切片操作
    • striptags
      • 删除字符串中所有的html标签
    • truncatechars
      • 对字符串进行切割，并且会拼接三个点来作为省略号
• 自定义过滤器
  • 步骤
    • 在项目目录下创一个文件夹
      • templatetags 固定的名称
    • 在templatetags目录下建一个py文件用于写代码
      • 导入模块
        • from django.template import Library-
      • 定义过滤器函数
      • 将过滤器函数注册进去django项目
    • 导入过滤器的py文件
      • {%load filters_name%}
    • 使用方法与过滤器使用方法一致
• 模板结构优化
  • 引入模板
    • 有些代码在许多模板中都用的到，我们把这些代码抽取出来，进行引入，避免重复。
    • include
      • {% include '模板名' %}
      • 默认include标签包含模版，会自动的使用主模版中的上下文，也即可以自动的使用主模版中的变量。如果想传入一些其他的参数，那么可以使用with语句。
  • 模板继承
    • 模版继承类似于Python中的类，在父类中可以先定义好一些变量和方法，然后在子类中实现。
      • 模版继承也可以在父模版中先定义好一些子模版需要用到的代码，然后子模版直接继承就可以了。并且因为子模版肯定有自己的不同代码，因此可以在父模版中定义一个block接口，然后子模版再去实现。
    • {% extends "模板名" %}
      • extends标签必须放在模版的第一行。
    • block接口
      • 子模版中的代码必须放在block中
      • {{block.super}}
        • 在某个block中需要使用父模版的内容，那么可以使用{{block.super}}来继承。
      • {% block xxx %} {% endblock xxx %}
• 加载静态文件
  • css样式文件，js执行文件和图片在DTL中加载。
    • 使用static标签
  • 加载静态文件步骤
    • 首先确保django.contrib.staticfiles已经添加到settings.INSTALLED_APPS中。
    • 确保在settings.py中设置了STATIC_URL。
    • 在已经安装了的app下创建一个文件夹叫做static。
    • 如果有一些静态文件是不和任何app挂钩的。那么可以在settings.py中添加STATICFILES_DIRS。
      • STATICFILES_DIRS = [ os.path.join(BASE_DIR,"static") ]
    • 在模版中使用load标签加载static标签。
      • {% load static %}
      • {% static '文件路径' %}
    • 不在模板中使用load标签调用，在settings中添加builtins"
      • 在settings.py中的TEMPLATES/OPTIONS
      • 添加'builtins':['django.templatetags.static']
  • 手动将静态文件的url与静态文件的路径进行映射
    • from django.conf import settings
      • from . import settings
    • from django.conf.urls.static import static
    • urlpatterns = [ # 其他的url映射 ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)