Django 模版语法

一.简介

模版是纯文本文件。它可以产生任何基于文本的的格式（HTML，XML，CSV等等）。

模版包括在使用时会被值替换掉的变量，和控制模版逻辑的标签。

{% extends "base_generic.html" %}
 
{% block title %}{{ section.title }}{% endblock %}
 
{% block content %}
<h1>{{ section.title }}</h1>
 
{% for story in story_list %}
<h2>
  <a href="{{ story.get_absolute_url }}">
    {{ story.headline|upper }}
  </a>
</h2>
<p>{{ story.tease|truncatewords:"100" }}</p>
{% endfor %}
{% endblock %}

1.变量

{{ variable }}

{#如果后台 渲染传过来的是字典格式的数据 那么前端页面解析值 dict={"k1":"v1"} 假设传的是{"dict": dict} 前端页面取值 .字典key值#}
 
<h1>{{dict.k1}}</h1>

2.过滤器

　　可以通过使用 过滤器来改变变量的显示

格式：

{{ name|lower }}

过滤器参数;

{{ item.content |truncatewords:30 }}  <!-- 只显示 content 变量的前30个词 -->

default

{{ value|default:"nothing" }}   <!--如果一个变量是false或者为空，使用给定的默认值。否则，使用变量的值-->

length

返回值的长度。它对字符串和列表都起作用

{{ value|length }}

filesizeformat

将该数值格式化为一个 “人类可读的” 文件容量大小 （例如 '13 KB', '4.1 MB', '102 bytes', 等等)

{{ value|filesizeformat }}

add

把add后的参数加给value

{{ value|add:"2" }}  <!--如果 value 为 4,则会输出 6.-->

capfirst

将变量首字母变大写

{{ value|capfirst }}  <!--如果value是test过滤后转为Test-->

cut

移除value中所有的与给出的变量相同的字符串

{{ value|cut:" " }}

dictsort

根据指定的key值对列表字典排序，并返回

{{ value|dictsort:"name" }}

{% for book in books|dictsort:"author.age" %}
    * {{ book.title }} ({{ book.author.name }})
{% endfor %}

如给定值为：

[
    {'title': '1984', 'author': {'name': 'George', 'age': 45}},
    {'title': 'Timequake', 'author': {'name': 'Kurt', 'age': 75}},
    {'title': 'Alice', 'author': {'name': 'Lewis', 'age': 33}},
]

那么结果为:

* Alice (Lewis)
* 1984 (George)
* Timequake (Kurt)

random

随机返回一个值

{{ value|random }}

如果 value 是 列表 ['a', 'b', 'c', 'd'], 可能输出的是 "b"

slice

切片

{{ some_list|slice:":2" }}

如果 some_list 是 ['a', 'b', 'c'], 输出结果为 ['a', 'b']

truncatewords

字符串截断

{{ value|truncatewords:2 }}

如果 value 是 "Joel is a slug",输出 "Joel is ...".

二.自动HTML转义

默认情况下，Django 中的每个模板会自动转义每个变量的输出。明确地说，下面五个字符被转义：

< 会转换为<
> 会转换为>
' (单引号) 会转换为'
" (双引号)会转换为 "
& 会转换为 &

如何关闭

要控制模板上的自动转义，将模板（或者模板中的特定区域）包裹在autoescape标签中

{% autoescape off %}
    Hello {{ name }}
{% endautoescape %}

autoescape标签接受on 或者 off作为它的参数。有时你可能想在自动转义关闭的情况下强制使用它。下面是一个模板的示例：

Auto-escaping is on by default. Hello {{ name }}
 
{% autoescape off %}
    This will not be auto-escaped: {{ data }}.
 
    Nor this: {{ other_data }}
    {% autoescape on %}
        Auto-escaping applies again: {{ name }}
    {% endautoescape %}
{% endautoescape %}

自动转义标签作用于扩展了当前模板的模板，以及通过 include 标签包含的模板，就像所有block标签那样。例如：

{% autoescape off %}
<h1>{% block title %}{% endblock %}</h1>
{% block content %}
{% endblock %}
{% endautoescape %}

{% extends "base.html" %}
{% block title %}This &amp; that{% endblock %}
{% block content %}{{ greeting }}{% endblock %}

三.自定义simple_tag

自定义simple_tag

{% load humanize %}
 
{{ 45000|intcomma }}

load标签可以接受多个库名称，由空格分隔。例如

{% load humanize i18n %}

5.1 自定义标签代码

自定义模板标签和过滤器必须位于Django 的某个应用中。如果它们与某个已存在的应用相关，那么将其与应用绑在一起才有意义；否则，就应该创建一个新的应用来包含它。

这个应用应该包含一个templatetags 目录，和models.py、views.py等文件处于同一级别目录下，如果目录不存在则创建它——不要忘记创建__init__.py 文件以使得该目录可以作为Python 的包。在添加这个模块以后，在模板里使用标签或过滤器之前你将需要重启服务器。新建 PY文件

切记：目录名一定要是templatetags

自定义simple_tag

在templatetags目录下的py文件中写：

#!/usr/bin/env python
# -*- coding:utf-8 -*-
from django import template
from django.utils.safestring import mark_safe
 
register = template.Library()
 
@register.simple_tag
def my_simple_time(v1,v2,v3):
    return  v1 + v2 + v3

在HTML中写：

{% load xx %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
 
{% my_simple_time 1 2 3%}
 
</body>
</html>

在自定义simple_tag的html中不能用于if条件作为判断，so引出了自定义过滤器函数

自定义过滤器函数

（最多俩个参数，html中可以有if条件语句）

自定义的过滤器就是一个带1，2个参数的python函数，一个参数放变量值，一个用来放选项值，比如{{ var|remove:"bar" }}, var是变量值，"bar"是选项值。

在templatetags目录下的py文件中写：

#!/usr/bin/env python
# -*- coding:utf-8 -*-
from django import template
from django.utils.safestring import mark_safe
register = template.Library()
 
@register.filter
def detail3(value,arg):
    allcount, remainder = arg.split(',')
    allcount = int(allcount)
    remainder = int(remainder)
    if value%allcount == remainder:
        return True
    return False

在HTML中写：

{% load xx %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
 
{{  23|detail4:"4,0" }}
 
{% if  23|detail4:"4,0" %}
<h1>123</h1>
{% endif %}
 
</body>
</html>