Django - 模板語法

阿新 • • 發佈：2020-10-14

Django模板語法

一、什麼是模板？

只要是在html裡面有模板語法就不是html檔案了，這樣的檔案就叫做模板。

二、模板語法分類

一、模板語法之變數：語法為 {{ }}：

在 Django 模板中遍歷複雜資料結構的關鍵是句點字元 .（也就是點）

views.py

def index(request):
    name = "hello haiyan"
    i = 200
    l = [11,22,33,44,55]
    d = {"name":"haiyan","age":20}

    class People(object): #繼承元類
        def __init__(self,name,age):
            self.name = name
            self.age = age
        def __str__(self):
            return self.name+str(self.age)
        def dream(self):
            return "你有夢想嗎？"
    #例項化
    person_egon = People("egon",10)
    person_dada = People("dada",34)
    person_susan = People("susan",34)
    person_list = [person_dada,person_egon,person_susan]

    return render(request,"index.html",
                    {
                        "name":name,
                        "i":i,
                        "l":l,
                        "d":d,  #鍵對應的是模板裡的名字。值對應的是上面定義的變數
                        "person_egon":person_egon,
                        "person_dada":person_dada,
                        "person_list":person_list,
                    }
              )
    # return render(request,"index.html",locals())
    #用locals()可以不用寫上面的render了。不過用locals()，views裡面用什麼名。模板裡面就得用什麼名
    # locals()區域性的：用了locals就相當於都得按照上面的那樣

template/index.html

<h4>變數{{ z }}:深度查詢</h4><hr>
<h3>{{ name }}</h3>
<p>{{ i }}</p>
<p>{{ l }}</p>
<p>{{ d }}</p>
<p>{{ l.0 }}------》取單個值可通過句點符（也就是點）</p>
<p>{{ l.4 }}</p>
<p>{{ d.name }}</p>
<p>{{ d.age }}-----》字典也可以根據句點符取值，一個點就搞定了。
然而在前端頁面中是看不到你的模板語法的，當你點選審查元素的
時候，你就會發現，偷偷的換過來了</p>
<p>{{ person_dada.name }}</p>
<p>{{ person_egon.age }}</p>
<p>{{ person_dada.dream }}</p>  <!-- .方法的時候，注意當前的dream方法是沒有引數的-->
<p>{{ person_list.2 }}</p>  <!--單個取值-->
<p>{{ person_list.1.name }}</p>
<!-- 那怎麼讓物件變成字串呢？在index檢視函式裡裡面再加上一個__str__內建方法-->
<!--__str__是物件字串的改變-->

注意：句點符也可以用來引用物件的方法(無引數方法)。

<h4>字典:{{ dic.name.upper }}</h4>

二、模板語法之標籤：語法為 {% tag %}：

標籤看起來像是這樣的：{% tag %}。標籤比變數更加複雜：一些在輸出中建立文字，一些通過迴圈或邏輯來控制流程，一些載入其後的變數將使用到的額外資訊到模版中。

一些標籤需要開始和結束標籤（例如{% tag %} ...標籤內容 ... {% endtag %}）。

1、for標籤（注：迴圈序號可以通過｛｛forloop｝｝顯示）

<h3>迴圈取值1</h3><hr>
{% for item in person_list %}
    <p>{{ item.name }},{{ item.age }}</p>
{% endfor %}

<h3>迴圈取值2:倒序</h3><hr>
{% for item in person_list reversed %}
    <!--序號從1開始-->
    <p>{{ forloop.counter }}----->{{ item.name }},{{ item.age }}</p>
    <!--序號從0開始--><p>{{ forloop.counter0 }}----->{{ item.name }},{{ item.age }}</p><!-- 序號倒序 --><p>{{ forloop.revcounter }}----->{{ item.name }},{{ item.age }}</p>
{% endfor %}

<h3>迴圈取值3：字典</h3><hr>
{% for k,v in d.items %}
    <p>{{ k }},{{ v}}</p>
{% endfor %}

2、for....empty ：`for`標籤帶有一個可選的`{%empty%}`從句，以便在給出的組是空的或者沒有被找到時，可以有所操作。

{% for person in person_list %}
    <p>{{ person.name }}</p>

{% empty %}
    <p>sorry,no person here</p>
{% endfor %}

`3、if標籤：{%if%}會對一個變數求值，如果它的值是“True”（存在、不為空、且不是boolean型別的false值），對應的內容塊會輸出。`

{% if i > 300 %}
    <p>大於{{ i }}</p>
{% elif i == 200  %}
    <p>等於{{ i }}</p>
{% else %}
    <p>小於{{ i }}</p>
{% endif %}

4、with：使用一個簡單地名字快取一個複雜的變數，當你需要使用一個“昂貴的”方法（比如訪問資料庫）很多次的時候是非常有用的

{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

<p>{{ person_list.2.name }}</p>
{% with name=person_list.2.name %}
    <p>{{ name }}</p>
{% endwith %}

5、csrf_token：這個標籤用於跨站請求偽造保護

提交資料的時候就會做安全機制，當你點選提交的時候會出現一個forbbiddon
的錯誤，就是用setting配置裡的scrf做安全機制的，那麼我們可以吧它給註釋了，，，
或者在form表單下面新增一個{% csrf_token %},,,
這才是真正解決的辦法，註釋不是解決的辦法

<h3>scrf_token</h3><form action="/tag/" method="post">
    {% csrf_token %}
    <p><input type="text" name="haiyan"></p>
    <input type="submit">
</form>

三、模板語法之過濾器：語法{{obj|filter__name:param}}

`1、default：`如果一個變數是false或者為空，使用給定的預設值。否則，使用變數的值。例如：

<p>default過濾器：{{ li|default:"如果顯示為空，設定的解釋性的內容" }}</p>

2、length：返回值的長度。它對字串和列表都起作用。例如：

{{ value|length }}

如果 value 是 ['a', 'b', 'c', 'd']，那麼輸出是 4。

`3、filesizeformat：`將值格式化為一個 “人類可讀的” 檔案尺寸（例如`'13 KB'`,`'4.1 MB'`,`'102 bytes'`, 等等）。例如：

{{ value|filesizeformat }}

如果value是 123456789，輸出將會是117.7 MB。　　

4、date：如果 value=datetime.datetime.now()

{{ value|date:"Y-m-d" }}

5、slice ：切片

如果value="hello world"

{{ value|slice:"2:-1" }}

6、truncatechars 截斷

如果字串字元多於指定的字元數量，那麼會被截斷。截斷的字串將以可翻譯的省略號序列（“...”）結尾。

引數：要截斷的字元數

例如：

<p>截斷字元：{{ content|truncatechars:20 }}</p>
<p>截斷單詞：{{ content|truncatewords:4 }}</p>

如果content是“I am is haiyan,how are you asd df dfgfdgdg?

輸出結果：截斷字元：I am is haiyan,ho...

輸出結果：截斷單詞：I am is haiyan,how ...

7、safe

Django的模板中會對HTML標籤和JS等語法標籤進行自動轉義，原因顯而易見，這樣是為了安全。但是有的時候我們可能不希望這些HTML元素被轉義，比如我們做一個內容管理系統，後臺新增的文章中是經過修飾的，這些修飾可能是通過一個類似於FCKeditor編輯加註了HTML修飾符的文字，如果自動轉義的話顯示的就是保護HTML標籤的原始檔。為了在Django中關閉HTML的自動轉義有兩種方式，如果是一個單獨的變數我們可以通過過濾器“|safe”的方式告訴Django這段程式碼是安全的不必轉義。比如：

value="<a href="">點選</a>"

{{ value|safe}}

<p>{{ label }}</p>  <!--為了安全系統會把標籤變成字串-->
<p>{{ label|safe }}</p>    <!--加上safe，確定你的資料是安全的才能被當成是標籤-->

母板

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="x-ua-compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Title</title>
  {% block page-css %}
  
  {% endblock %}
</head>
<body>

<h1>這是母板的標題</h1>

{% block page-main %}

{% endblock %}
<h1>母板底部內容</h1>
{% block page-js %}

{% endblock %}
</body>
</html>

注意：我們通常會在母板中定義頁面專用的CSS塊和JS塊，方便子頁面替換。

繼承母板

在子頁面中在頁面最上方使用下面的語法來繼承母板。

{% extends 'layouts.html' %}

塊（block）

通過在母板中使用{% block xxx %}來定義"塊"。

在子頁面中通過定義母板中的block名來對應替換母板中相應的內容。

{% block page-main %}
  <p>世情薄</p>
  <p>人情惡</p>
  <p>雨送黃昏花易落</p>
{% endblock %}

元件

可以將常用的頁面內容如導航條，頁尾資訊等元件儲存在單獨的檔案中，然後在需要使用的地方按如下語法匯入即可。

{% include 'navbar.html' %}

靜態檔案相關

{% static %}

{% load static %}
<img src="{% static "images/hi.jpg" %}" alt="Hi!" />

引用JS檔案時使用：

{% load static %}
<script src="{% static "mytest.js" %}"></script>

某個檔案多處被用到可以存為一個變數

{% load static %}
{% static "images/hi.jpg" as myphoto %}
<img src="{{ myphoto }}"></img>

{% get_static_prefix %}

{% load static %}
<img src="{% get_static_prefix %}images/hi.jpg" alt="Hi!" />

或者

{% load static %}
{% get_static_prefix as STATIC_PREFIX %}

<img src="{{ STATIC_PREFIX }}images/hi.jpg" alt="Hi!" />
<img src="{{ STATIC_PREFIX }}images/hi2.jpg" alt="Hello!" />

這裡簡單介紹一些常用的模板的過濾器

四、自定義標籤和過濾器

1、在settings中的INSTALLED_APPS配置當前app，不然django無法找到自定義的simple_tag.

2、在app中建立templatetags模組(模組名只能是templatetags)

3、在templatetags裡面建立任意.py檔案，

如：my_tags.py

from django import template

# 固定寫法，生成一個註冊例項物件
register = template.Library()


@register.filter()  # 告訴Django的模板語言我現在註冊一個自定義的filter
def add_sb(value):
    """
    給任意指定的變數新增sb
    :param value: |左邊被修飾的那個變數
    :return: 修飾後的變數內容
    """
    return value + 'sb'


@register.filter()
def add_str(value, arg):
    return value + arg

templates 下html檔案中呼叫

{% load my_tags %}

<p>{{ name|add_sb }}</p>
<p>{{ name|add_str:'大好人' }}</p>

simple_tag

和自定義filter類似，只不過接收更靈活的引數。

定義註冊simple tag

@register.simple_tag(name="plus")
def plus(a, b, c):
    return "{} + {} + {}".format(a, b, c)

使用自定義simple tag

{% load app01_demo %}

{# simple tag #}
{% plus "1" "2" "abc" %}

inclusion_tag

1 定義函式
可以接受引數
返回一個字典
2. 函式上加裝飾器
@register.inclusion_tag('pagination.html')
3. 函式返回的字典交給 pagination.html 渲染

mytags.py

from django import template

register = template.Library()


@register.inclusion_tag('pagination.html')
def pagination(total, current_num):
    return {'total': range(1, total + 1), 'current_num': current_num}