目錄
一、模板含義
模板雖然是HTML文件,但是Django不是直接把HTML文件返回給用戶,而是經過了 模板語言的轉換,再返回。模板轉化 這一套,我覺得在 全棧開發 前端頁面時候,能減少大量的重復性工作。
二、模板的組成
組成:HTML代碼+邏輯控制代碼。
三、邏輯控制代碼的組成
1. 變量(使用雙大括號來引用變量)
語法格式: {{var_name}}
>>> python manange.py shell (進入該django項目的環境) >>> from django.template import Context, Template >>> t = Template('My name is {{ name }}.') >>> c = Context({'name': 'Stephane'}) >>> t.render(c) 'My name is Stephane.' # 同一模板,多個上下文,一旦有了模板對象,你就可以通過它渲染多個context,無論何時我們都可以 # 像這樣使用同一模板源渲染多個context,只進行 一次模板創建然后多次調用render()方法渲染會 # 更為高效: # Low for name in ('John', 'Julie', 'Pat'): t = Template('Hello, {{ name }}') print t.render(Context({'name': name})) # Good t = Template('Hello, {{ name }}') for name in ('John', 'Julie', 'Pat'): print t.render(Context({'name': name}))
Django 模板解析非常快捷。 大部分的解析工作都是在后台通過對簡短正則表達式一次性調用來完成。 這和基於 XML 的模板引擎形成鮮明對比,那些引擎承擔了 XML 解析器的開銷,且往往比 Django 模板渲染引擎要慢上幾個數量級。下面就是例子
from django.shortcuts import render,HttpResponse from django.template.loader import get_template #記得導入 # Create your views here. import datetime from django.template import Template,Context # def current_time(req): #原始的視圖函數 # now=datetime.datetime.now() # html="<html><body>現在時刻:<h1>%s.</h1></body></html>" %now # return HttpResponse(html) # def current_time(req): #django模板修改的視圖函數 # now=datetime.datetime.now() # t=Template('<html><body>現在時刻是:<h1 style="color:red">{{current_date}}</h1></body></html>') #t=get_template('current_datetime.html') # c=Context({'current_date':now}) # html=t.render(c) # return HttpResponse(html) #另一種寫法(推薦) def current_time(req): now=datetime.datetime.now() return render(req, 'current_datetime.html', {'current_date':now})
深度變量的查找(萬能的句點號)
在到目前為止的例子中,我們通過 context 傳遞的簡單參數值主要是字符串,然而,模板系統能夠非常簡潔地處理更加復雜的數據結構,例如list、dictionary和自定義的對象。
在 Django 模板中遍歷復雜數據結構的關鍵是句點字符 (.)。
#最好是用幾個例子來說明一下。 # 首先,句點可用於訪問列表索引,例如: >>> from django.template import Template, Context >>> t = Template('Item 2 is {{ items.2 }}.') >>> c = Context({'items': ['apples', 'bananas', 'carrots']}) >>> t.render(c) 'Item 2 is carrots.' #假設你要向模板傳遞一個 Python 字典。 要通過字典鍵訪問該字典的值,可使用一個句點: >>> from django.template import Template, Context >>> person = {'name': 'Sally', 'age': '43'} >>> t = Template('{{ person.name }} is {{ person.age }} years old.') >>> c = Context({'person': person}) >>> t.render(c) 'Sally is 43 years old.' #同樣,也可以通過句點來訪問對象的屬性。 比方說, Python 的 datetime.date 對象有 #year 、 month 和 day 幾個屬性,你同樣可以在模板中使用句點來訪問這些屬性: >>> from django.template import Template, Context >>> import datetime >>> d = datetime.date(1993, 5, 2) >>> d.year 1993 >>> d.month 5 >>> d.day 2 >>> t = Template('The month is {{ date.month }} and the year is {{ date.year }}.') >>> c = Context({'date': d}) >>> t.render(c) 'The month is 5 and the year is 1993.' # 這個例子使用了一個自定義的類,演示了通過實例變量加一點(dots)來訪問它的屬性,這個方法適 # 用於任意的對象。 >>> 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('John', 'Smith')}) >>> t.render(c) 'Hello, John Smith.' # 點語法也可以用來引用對象的方法。 例如,每個 Python 字符串都有 upper() 和 isdigit() # 方法,你在模板中可以使用同樣的句點語法來調用它們: >>> from django.template import Template, Context >>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}') >>> t.render(Context({'var': 'hello'})) 'hello -- HELLO -- False' >>> t.render(Context({'var': '123'})) '123 -- 123 -- True' # 注意這里調用方法時並 *沒有* 使用圓括號() 而且也無法給該方法傳遞參數;你只能調用不需參數的方法。所以需要參數的方法調用不了
變量的過濾器(filter)的使用 https://docs.djangoproject.com/en/2.2/ref/templates/language/#filters
# 1 add : 給變量加上相應的值
# # 2 addslashes : 給變量中的引號前加上斜線
# # 3 capfirst : 首字母大寫
# # 4 cut : 從字符串中移除指定的字符
# # 5 date : 格式化日期字符串
# # 6 default : 如果值是False,就替換成設置的默認值,否則就是用本來的值
# # 7 default_if_none: 如果值是None,就替換成設置的默認值,否則就使用本來的值
#實例:
#value1="aBcDe"
{{ value1|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>' 后端傳了個 a標簽 {{ value6 }} # 這個在顯示時候就是 a 標簽格式的字符串 {{ value6|safe }}<br> # 加 safe 過濾器,會渲染出 a標簽
{% autoescape off %} # 效果一樣,把安全機制關閉 {{ value6 }}
{% endautoescape %}
{{ value6|striptags }} # 變成 text
#value7='1234'
{{ value7|filesizeformat }}<br> {{ value7|first }}<br> {{ value7|length }}<br> {{ value7|slice:":-1" }}<br>
#value8='http://www.baidu.com/?a=1&b=3'
{{ value8|urlencode }}<br> # 得到編碼后的URL文本 http%3A//www.baidu.com/%3Fa%3D1%26b%3D3
2. 標簽(tag)的使用(使用大括號和百分比的組合來表示使用tag)
https://docs.djangoproject.com/en/2.2/ref/templates/builtins/#built-in-tag-reference
{% tags %} 常用的 if for csrf_token url
------{% if %} 的使用
{% if num >= 100 and 8 %} {% 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 %} {% if %} 標簽接受and,or或者not來測試多個變量值或者否定一個給定的變量 {% if %} 標簽不允許同一標簽里同時出現and和or,否則邏輯容易產生歧義,例如下面的標簽是不合法的:
{% if obj1 and obj2 or obj3 %}
{% for %}的使用
{% for %}標簽允許你按順序遍歷一個序列中的各個元素,每次循環模板系統都會渲染{% for %}和{% endfor %}之間的所有內容
<ul> {% for obj in list %} <li>{{ obj.name }}</li> {% endfor %} </ul>
#在標簽里添加reversed來反序循環列表:
{% for obj in list reversed %} ... {% endfor %} #{% for %}標簽可以嵌套:
{% for country in countries %} <h1>{{ country.name }}</h1>
<ul> {% for city in country.city_list %} <li>{{ city }}</li> {% endfor %} </ul> {% endfor %} #系統不支持中斷循環,系統也不支持continue語句,{% for %}標簽內置了一個forloop模板變量, #這個變量含有一些屬性可以提供給你一些關於循環的信息
1,forloop.counter表示循環的次數,它從1開始計數,第一次循環設為1: {% for item in todo_list %} <p>{{ forloop.counter }}: {{ item }}</p> {% endfor %} 2,forloop.counter0 類似於forloop.counter,但它是從0開始計數,第一次循環設為0 3,forloop.revcounter 4,forloop.revcounter0 5,forloop.first當第一次循環時值為True,在特別情況下很有用: {% for object in objects %} {% if forloop.first %}<li class="first">{% else %}<li>{% endif %} {{ object }} </li> {% endfor %} # 富有魔力的forloop變量只能在循環中得到,當模板解析器到達{% endfor %}時forloop就消失了 # 如果你的模板context已經包含一個叫forloop的變量,Django會用{% for %}標簽替代它 # Django會在for標簽的塊中覆蓋你定義的forloop變量的值 # 在其他非循環的地方,你的forloop變量仍然可用
#{% empty %} 跟 for 標簽 搭配用,便利某個列表,如果是空的,那么會 渲染 empty 標簽
{{ li }} {# li 是傳遞的列表,li=[11,22,33,44,55] #} {% for i in li %} <li>{{ forloop.counter0 }}----{{ i }}</li> {% empty %} <li>this is empty!</li> {% endfor %} # [11, 22, 33, 44, 55] # 0----11 # 1----22 # 2----33 # 3----44 # 4----55
------{%csrf_token%}:csrf_token標簽
用於生成csrf_token的標簽,用於防治跨站攻擊驗證。注意如果你在view的index里用的是render_to_response方法,不會生效
其實,這里是會生成一個input標簽,和其他表單標簽一起提交給后台的。
<input type='hidden' name='csrfmiddlewaretoken' value='XzmSI7MhIWmE0GbxeVaw27HSHhbvmV309YhdWa9gHn6GNerARqsoEvskBqPgKo1P' />
------{% url %}: 引用路由配置的地址
<form action="{% url "bieming"%}" > <input type="text"> <input type="submit"value="提交"> {%csrf_token%} </form>
栗子: url 標簽可以傳參數
<a href="/polls/{{ question.id }}/"> ---> <a href="{% url 'detail' question_id %}">
這個是為了在 模板的 過濾器 和標簽 都不適用情況下,自己定義
------a、在app中創建templatetags模塊【文件夾】(必須的)
------b、創建任意 .py 文件,如:my_tags.py
from django import template from django.utils.safestring import mark_safe register = template.Library() #register的名字是固定的,不可改變
# filter 格式 @register.filter def filter_multi(v1,v2): return v1 * v2 # tag 格式 @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)
------c、在使用自定義simple_tag和filter的html文件中導入之前創建的 my_tags.py :{% load my_tags %}
------d、使用simple_tag和filter(如何調用)
-------------------------------.html {% load xxx %} #首行 # num=12 過濾器 {{ num|filter_multi:2 }} #24 {{ num|filter_multi:"[22,333,4444]" }} # 標簽 {% simple_tag_multi 2 5 %} 參數不限,但不能放在if for語句中 {% simple_tag_multi num 5 %}
------e、在settings中的INSTALLED_APPS配置當前app,不然django無法找到自定義的simple_tag. 並且重啟
注意:
filter可以用在if等語句后,simple_tag不可以。意思是 過濾器能放到 if標簽里面,但是 自定義的simple_tag 不能放到 if 標簽里面。
{% if num|filter_multi:30 > 100 %} {{ num|filter_multi:30 }} {% endif %}
模板繼承,在於有被多個HTML復用的HTML元素,此可為模板,在需要變化的部分就可以自由定制出想要的效果。
基礎模板用到的
{% block content %} content 是這個block 的命名
{% endblock %} 定義一個block,這個block的內容會被子模板重寫的block替換掉【如果子模板使用了該block的話】
子模板用到的
{% extends "base.html" %} 繼承一個基礎模板HTML 【放在第一行】
{% block content %}
{% endblock %} 重寫一個block,這個block的內容會替換掉 基礎模板 同一個block 【命名唯一】
{{ block.super }} 獲取到基礎模板 該block的 內容【這個變量寫在 block 標簽里面】
可能需要被重寫的地方越多,那越需要定義 block,這樣擴展性提高,冗余性降低。
include 模板標簽
內建模板標簽: {% include %} 。該標簽允許在(模板中)包含其它的模板的內容。 標簽的參數是所要包含的模板名稱,可以是一個變量,也可以是用單/雙引號硬編碼的字符串。 每當在多個模板中出現相同的代碼時,就應該考慮是否要使用 {% include %} 來減少重復。使用時候在子模板開頭【不要在extends 標簽前面】加上{% load staticfiles %} 標簽。
{% include "base.html" %} 在該模板HTML 中 引入 另一個HTML 。