Django 模板

1. 模板的组成

• HTML代码+逻辑控制代码

2. 逻辑控制代码的组成

2.1 变量格式: {{var_name}}

# 示例: Template 和 Context 对象
# Terminal
python manage.py shell      # 进入该django项目的环境
from django.template import Context, Template
t = Template('My name is {{ name }}')
c = Context({'name':'xiaohu'})
t.render(c)


# 同一模板,多个上下文,一旦有了模板对象,就可以通过它渲染多个context,无论何时我们都可以像这样
# 使用同一模板源渲染多个 context,只进行一次模板创建,然后多次调用 render()方法渲染会更为高效:

# 低效:
from name in ('小虎','小猪','旺仔'):
    t = Template('Hello, {{ name }}')
    print t.render(Context({'name': name}))

# 推荐
t = Template('Hello, {{ name }}')
from name in ('小虎','小猪','旺仔'):
    print t.render(Context({'name': name}))

2.2 万能的句点号

• 到目前为止,我们通过context传递的简单参数值主要是字符串,然而,模板系统能够非常简洁地处理更加复杂的数据
  结构,例如list,dictionary和自定义的对象。
• 在Django模板中遍历复杂数据结构的关键是句点字符(.)

# 以下均在 iTerm 中操作

# 示例一:句点可用于访问列表索引
from django.template import Template, Context
t = Template('I have ate {{ items.2 }}')
c = Context({'items': ['apples', 'bananas', 'carrots']})
t.render(c)     # 输出: I have ate carrots

# 示例二:通过字典键访问字典的值,可以使用句点
from django.template import Template, Context
person = {'name':'xiaohu', 'age':'22'}
t = Template('{{ person.name }} is {{ person.age }} years old.')
c = Context({'person':person})
t.render(c)     # 输出: xiaohu is 22 years old.

# 示例三: 通过句点访问对象的属性.例如,Python中 datetime.date 对象有 year, month, day 几个属性
from django.template import Template, Context
import datetime
d = datetime.date(1998, 2, 18)

t = Template('The month is {{ date.month }} and the year is {{ date.year }}.')
c = Context({'date': d})
t.render(c)     # 输出: The month is 2 and the year is 1998.

# 示例四: 通过句点访问自定义对象的属性
from django.template import Template, Context
class Person(object):
    def __init__(self, first_name, last_name):
        self.first_name, self.last_name = first_name, last_name

t = Template('Hello, {{ person.first_name }} {{ person.last_name }}.')
c = Context({'person': Person('Jhon', 'Smith')})
t.render(c)

# 示例五: 通过句点访问对象的方法
from django.template import Template, Context
t = Template('{{ var }} --- {{ var.upper }} -- {{ var.isdigit }}')
t.render(Context({'var':'hello'}))
# 输出: hello -- HELLO -- False
# 注意:
#   这里调用方法时,并没有使用圆括号,而且也无法给该方法传递参数;只能调用不需要参数的方法;

2.3 变量的过滤器(filter)

# 语法格式:
{{obj|filter:param}}

# param 的值:
    # add:      给变量加上相应的值;
    # addslashes: 给变量中的引号前加上斜线;
    # capfirst: 首字母大写;
    # cut:      从字符串中移除指定的字符;
    # date:     格式化日期字符串;
    # default:  如果值是False, 就替换成设置的默认值,否则就用本来的值;
    # default_if_none: 如果值是None,就替换成设置的默认值,否则就用本来的值;

# 示例:
# value1='aBcDe'
{{ value|upper }}<br/>

# value2=5
{{ value2|add:3 }}<br/>

# value3='he  llo wo r ld'
{{ value3|cut:' '}}<br/>

# import datetime
# value4=datetime.datetime.now()
{{ value4|date:'Y-m-d'}}<br/>

# value5=[]
{{ value5|default:'空的'}}<br/>

#value6='<a href="#">跳转</a>'
{{ value6 }}

{% autoescape off %}
    {{ value6 }}
{% endautoescape %}

{{ value6|safe }}<br/>

{{ value6|striptags }}

# value7='1234'
{{ value7|filesizeformat }}<br/>
{{ value7|first }}<br/>
{{ value7|length }}<br/>
{{ value7|slice:':-1'}}<br/>

2.4 标签(tag)的使用(使用大括号和百分比的组合来表示使用tag)

• {% tags %}

# 示例一: {% if %}
{% if num >= 100%}
    {% if num > 200 %}
        <p>num大于200</p>
    {% else %}
        <p>num大于100小于200</p>
    {% endif %}
{% elif num < 100 %}
    <p>num 小于100</p>
{% else %}
    <p>num 等于100</p>
{% endif %}


# 示例二:{% for %}
<ul>
{% for obj in list %}
    <li>{{ obj.name }}</li>
{% endfor %}
</ul>

# 在标签里添加reversed,来反序循环列表
{% for obj in list reversed %}
    ....
{% endfor %}

# 系统不支持中断循环,也不支持continue语句, {% for %}标签内置了一个forloop模板变量,
# 这个变量含有一些属性可以提供一些关于循环的信息;

# forloop.counter 表示循环的次数,它从1开始计数,第一次循环设为1:
    {% for item in todo_list %}
        <p>{{ forloop.counter }}: {{ item }}</p>
    {% endfor %}

# forloop.counter0 类似于forloop.counter, 但它是从0开始计数,第一次循环设为0
# forloop.first 当第一次循环时,值为True:
    {% for object in objects %}
        {% if forloop.first %}<li class="first">{% else %}<li>{% endif %}
        {{ object }}
        </li>
    {% endfor %}


# 示例三: {% csrf_token %}
# 用于生成 csrf_token 标签,用于防止跨站攻击验证;如果在view的index里用的是 render_to_response 方法,
# 不会生效;
# {% csrf_token %} 其实,这里生成一个 input 标签,和其他表单标签一起提交给后台;

<form action="{% url 'book' %}">
    <input type="text" name="username">
    <input type="password" name="pwd">
    <input type="submit" value="提交">
    {% csrf_token %}
</form>


# 示例四: {% with %} 用更简单的变量名替换复杂的变量名
{% with total=fhdhdfkldflkdf %}{{ total }}{% endwith %}

# 示例五: {% verbatin %} 原样输出
{% verebatim %}
    {{ hello }}
{% endverbatim %}

2.5 自定义 simple_tag

# 示例: 自定义filter 和 simple_tag

# Step1: 创建 mysite/templatetags 模块(名称固定)
# Step2: 在该文件夹下,创建任意 .py 文件,例如,my_tags.py
# Step3: 编写自定义代码 mysite/templatetags/my_tags.py
from django import template
from django.utils.safestring import mark_safe

register = template.Library()       # register 的名称是固定的,不可改变

@register.filter
def fitler_multi(v1, v2):
    return v1 * v2

@register.simple_tag
def simple_tag_multi(v1, v2):
    return v1 * v2

@register.simple_tag
def my_input(id, arg):
    result = "<input type='text' id='%s' class='%s' />" % (id, arg,)
    return mark_safe(result)

# Step4: 在html文件中,导入自定义的 my_tags.py
{% load my_tags %}
<!DOCTYPE html>
<html>
<head>
</head>
<body>
    {{ num|filter_multi:2 }}

    {% simple_tag_multi 2 5 %}
</body>
</html>

# Step5: 在 settings 中的 INSTALLED_APPS 配置当前项目 mysite

# 注意:
#   filter 可以用在 if 等语句后, simple_tag 不可以
{% if num|filter_multi:30 > 100 %}
    {{ num|filter_multi:30 }}
{% endif %}

2.6 extend 模板继承

• 模板继承:就是先构造一个基础框架模板,而后在其子模板中对它所包含站点公用部分和定义块进行重载;

# 示例:
# Step1: 定义基础模板

# templates/base.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
    <title>{% block title %}{% endblock %}</title>
</head>
<body>
    <h1>My helpful timestamp site</h1>
    {% block content %}{% endblock %}
    {% block footer %}
    <hr>
    <p>Thanks for visiting my site.</p>
    {% endblock %}
</body>
</html>

# 子模板的作用就是重载,添加或保留那些块的内容
# current_datetime.html
{% extends "base.html" %}

{% block title %}The current time{% endblock%}

{% block content %}
<p>It is now {{ current_date }}.</p>
{% endblock %}


# hours_head.html
{% extends "base.html"%}

{% block title %}Future time{% endblock %}

{% block content %}
<p>In {{ hour_offset }} hour(s), it will be {{ next_time }}.</p>
{% endblock%}

参考资料:

• Python 全栈
• Python 模板