Django之模板語法

Django之模板語法

目錄：
    1、什麼是模板
    2、模板語法分類
        - 模板語法之變量：語法{{}}
        - 模板語法之標籤：語法爲{% tag %}
        - 模板語法之過濾器：語法{{obj|filter__name:param}}
        - 自定義標籤和過濾器

1、什麼是模板
    - 只要是在html裏面的模板語法就不是html文件了，這樣的文件叫作模板。

2、模板的語法分類
    - 模板語法之變量：語法爲{{}}
        - 在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_jack = People("jack",10)
                    person_tom = People("tom",34)
                    person_ward = People("ward",34)
                    person_list = [person_ward,person_jack,person_tom]
                    
                    return render(request,"index.html",
                                  {
                                  "name":name,
                                  "i":i,
                                  "l":l,
                                  "d":d,  #鍵對應的是模板裏的名字。值對應的是上面定義的變量
                                  "person_jack":person_jack,
                                  "person_tom":person_tom,
                                  "person_list":person_list,
                                  }
                                  )
                # return render(request,"index.html",locals())
                #用locals()能夠不用寫上面的render了。不過用locals()，views裏面用什麼名。模板裏面就得用什麼名
                # locals()局部的：用了locals就至關於都得按照上面的那樣

            - templates.index.hrtml
                
                <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_tom.name }}</p>
                <p>{{ person_jack.age }}</p>
                <p>{{ person_tom.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的錯誤，
                就是用settings配置裏的scrd作安全機制的，能夠註釋或者在form表單下面添加
                一個{% 5）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。

        三、filesizeformat：將值格式化爲一個 「人類可讀的」 文件尺寸 （例如 '13 KB', '4.1 MB', '102 bytes', 等等）。例如：

        {{ value|filesizeformat }}
        若是 value 是 123456789，輸出將會是 117.7 MB。

        四、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，肯定你的數據是安全的才能被當成是標籤-->

    - 自定義標籤和過濾器

        1、在settings中的INSTALLED_APPS配置當前app，否則django沒法找到自定義的simple_tag.

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

        3、在templatetags裏面建立任意 .py 文件，

        如：my_tags.py


        from django import template
        from django.utils.safestring import mark_safe

        register = template.Library()   #register的名字是固定的,不可改變
        @register.filter   過濾器
        def multi(x,y):
            return x*y

        @register.simple_tag  標籤
        def multitag(x,y,z):
            return x*y*z
        @register.simple_tag  標籤
        def my_input(id,arg):
        　　 result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
        　　 return mark_safe(result)

        4、在使用自定義simple_tag和filter的html文件中導入以前建立的 my_tags.py

        {% load my_tags %}
        5、使用simple_tag和filter（如何調用）

        過濾器： {{ var|filter_name:參數 }} # 參數只能是兩個，一個參數是變量var ，一個是參數是後面的那個參數

        標籤： {% simple_tag 參數1 參數2 ... %}


        -------------------------------.html
        {% load xxx %}

        # num=12
        {{ num|multi:2 }} #24

        {{ num|multi:"[22,333,4444]" }}   至關於複製了，吧[22,333,4444]乘了num遍
        {% multitag 2 5 6 %} 參數不限,但不能放在if for語句中 {% simple_tag_multi num 5 %}


        自定義過濾器函數的參數只能兩個，能夠進行邏輯判斷
        自定義標籤無參數限制，不能進行邏輯判斷
        {% if i|multi:5 > 1000 %}   <!-- 判斷i*5>1000 -->
            <p>大於{{ i }}</p>
        {% else %}
            <p>大於等於{{ i }}</p>
        {% endif %}

 

    - 組件 include
        - 能夠將經常使用的頁面內容如導航條，頁尾信息等組件保存在單獨的文件中，而後在須要使用的地方按以下語法導入便可。
            {% include 'navbar.html' %}

    - 靜態文件相關（動態拿取STATIC_URL配置的名字）
        - 
            {% 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!" />

    - 自定義simpletag
        和自定義filter相似，只不過接收更靈活的參數。

        定義註冊simple tag
        @register.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
        - 多用於返回html代碼片斷

        - 步驟
            - 在app下建立templatetags的python包
            - 在包下寫py文件 mytags
            - 編輯文件
                - from django import template
                - register = template.Library()

            - 定義函數
                - 可接受參數
                - 返回一個字典
            - 函數加裝飾器
                - @register.inclusion_tag('result.html')

        示例：

            templatetags/my_inclusion.py

            
                from django import template

                register = template.Library()


                @register.inclusion_tag('result.html')
                def show_results(n):
                    n = 1 if n < 1 else int(n)
                    data = ["第{}項".format(i) for i in range(1, n+1)]
                    return {"data": data}
        
            templates/result.html

                <ul>
                  {% for choice in data %}
                    <li>{{ choice }}</li>
                  {% endfor %}
                </ul>
            
            templates/index.html
                
                <!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>inclusion_tag test</title>
                </head>
                <body>

                {% load my_inclusion %}

                {% show_results 10 %}
                </body>
                </html>