Django模板技术--Django播客系统(四)

一时失言乱红尘 2024-04-19 10:38 74阅读 0赞

# Django模板技术–Django播客系统(四) #

### 文章目录 ###

*  Django模板技术--Django播客系统(四)
 *   *  模板配置
     *  模板渲染
     *  DTL语法(模板语法)
     *   *  变量
         *  模板标签
         *  模板实例
         *  附加--Pycharm模板自定义

如果使用react实现前端页面，其实Django就没有必须使用模板，它其实就是一个纯后台服务程序，接收请求，响应数据，前端接口设计就可以是纯粹的Restful风格。

模板的目的就是为了可视化，将数据按照一定布局格式输出，而不是为了数据处理，所以一般不会有复杂的处理逻辑。模板的引入实现了业务逻辑和显示格式的分离。这样，在开发中，就可以分工协作，页面开发完成页面布局设计，后台开发完成数据处理逻辑实现。

*  Python的模板引擎默认使用Django template language(DTL)构建

## 模板配置 ##

*  在`djweb/settings.py`中，设置模板项目的路径

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) #这句话取项目根目录
    TEMPLATES = [
        { 
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [os.path.abspath(os.path.join(BASE_DIR,'templates'))], #制定模板文件夹路径
            'APP_DIRS': True,
            'OPTIONS': { 
                'context_processors': [
                    'django.template.context_processors.debug',
                    'django.template.context_processors.request',
                    'django.contrib.auth.context_processors.auth',
                    'django.contrib.messages.context_processors.messages',
                ],
            },
        },
    ]

*  **DIRS**:列表，定义模板文件的搜索路径顺序。os.path.join(BASE\_DIR,‘templates’)即项目根目录下templates目录，请构建这个目录。
    
    1.  项目根目录中构建templates文件夹。模板文件目录  
        ![django4\_001][django4_001]
 *  **APP\_DIRS**:是否运行在每个已经安装的应用中查找模板。应用自己目录下游templates目录，例如：`django/contrilb/admin/templates`。如果应用需要可分离、可重用，建议吧模板放到应用目录下
 *  **BASE\_DIR**是项目根目录，`os.path.join(BASE_DIR,'templates')`就是在manage.py这一层建立一个目录templates。这个路径就是以后默认找模板的地方。

## 模板渲染 ##

*  **模板页**
    
    1.  新建html文件，在`/templates/index.html`目录下
    
        <!DOCTYPE html>
        <html lang="en">
        <head>
            <meta charset="UTF-8">
            <title>Django web 模板技术</title>
        </head>
        <body>
        我是模板，数据是{
             {content}}
        </body>
        </html>
 *  **模板处理**
    
    1.  **加载模板**：模板是一个文件，需要从磁盘读取并加载。要将模板放置在指定的模板文件夹中
    2.  **渲染**：模板需要使用内容数据渲染
    3.  测试：修改`djweb/urls.py`文件中的index函数。
    
        from django.template import loader
        
        def index(request:HttpRequest):
            """视图函数：请求进来返回响应"""
            template = loader.get_template("index.html") #加载器模块搜索模板并加载它
            print(template.origin) #显示模板路径
            context = { "content":"www.xdd.com"} #字典数据
            return HttpResponse(template.render(context,request))
    
    1.  运行server `python manage.py runserver`  
        ![django4\_002][django4_002]
    2.  访问`http://127.0.0.1:8000/`界面如下：可以看到  
        ![django4\_003][django4_003]
 *  **render快捷渲染函数**
    
    1.  上面2个步骤代码编写繁琐，Django提供了对其的封装————快捷函数render。
    2.  `render(request,template_name,context=None)` 返回HTTPResponse对象
        
         *  template\_name \#模板名称
         *  context 数据字典
         *  render\_to\_string() 是其核心方法，其实就是拿数据替换HTML中的指定位置后返回一个字符串
    
        from django.shortcuts import  render
        
        def index(request:HttpRequest):
            """视图函数：请求进来返回响应"""
            return render(request,"index.html",{ "content":"www.xdd.com"})

## DTL语法(模板语法) ##

### 变量 ###

*  语法：`{ { variable }}`
 *  变量名由字母、数字、下划线、点号组成。
 *  点号使用的时候，例如foo.bar,遵循以下顺序：
    
    1.  字典查找，例如`foo["bar"]`,把foo当做字典，bar当做key
    2.  属性或方法的查找，例如`foo.bar`,把foo当做对象，bar当做属性或方法
    3.  数字索引查找，例如`foo[1]`,把foo当做列表一样，使用索引访问
    4.  示例： 修改`djweb/urls.py`文件中的index函数
        
            from django.shortcuts import  render
            import datetime
            
            def index(request:HttpRequest):
                """视图函数：请求进来返回响应"""
                my_dict = { 
                    "a":100,
                    "b":0,
                    "c":list(range(10,20)),
                    "d":'abc',
                    "date":datetime.datetime.now()
                }
                context = { "content":"www.xdd.com","my_dict":my_dict}
                return render(request,"index.html",context)
        
         *  如果**变量未能找到，则缺省插入空字符串**。
         *  在**模板中调用方法，不能加小括号**，自然也不能传递参数。
         *  `{ {my_dict.a}}`复合第一条，当做字典的key就可以访问了
         *  `{ {my_dict.keys}}`正确写法。符合第二条，当做my\_dict对象的属性和方法。
         *  错误写法`{ {my_dict.keys()}}`。

### 模板标签 ###

1.  **`if/else`标签**
    
     *  基本语法如下：
        
            {% if condition %}
                ... display
            {% endif %}
        
            {% if condition %}
                ... display 1
            {% elif condition2 %}
                ... display 2
            {% else %}
                ... display 3
            {% endif %}
     *  条件也支持`and、or、not`
     *  注意,因为这些标签是断开的，所以不能像Python一样使用缩进就可以表示出来，必须有个结束标签，例如endif、endfor。
2.  **`for`标签**
    
     *  [https://docs.djangoproject.com/en/2.0/ref/templates/builtins/\#for][https_docs.djangoproject.com_en_2.0_ref_templates_builtins_for]
    
        <!DOCTYPE html>
        <html lang="en">
        <head>
            <meta charset="UTF-8">
            <title>Django web 模板技术</title>
        </head>
        <body>
        我是模板，数据是{
             {content}}
        
        <ul>
        {% for athlete in athlete_list  %}
            <li>{
             { athlete.name }}</li>
        {% endfor %}
        </ul>
        
        <ul>
        {% for person in person_list %}
            <li> {
             { person.name }}</li>
        {% endfor %}
        </ul>
        </body>
        </html>
    
    <table> 
     <thead> 
      <tr> 
       <th align="left">变量</th> 
       <th align="left">说明</th> 
      </tr> 
     </thead> 
     <tbody> 
      <tr> 
       <td align="left"><code>forloop.counter</code></td> 
       <td align="left">当前循环从1开始的计数</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.counter0</code></td> 
       <td align="left">当前循环从0开始的计数</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.revcounter</code></td> 
       <td align="left">从循环的末尾开始倒计数1</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.revcounter0</code></td> 
       <td align="left">从循环的末尾开始倒计数到0</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.first</code></td> 
       <td align="left">第一次进入循环</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.last</code></td> 
       <td align="left">最后一次进入循环</td> 
      </tr> 
      <tr> 
       <td align="left"><code>forloop.parentloop</code></td> 
       <td align="left">循环嵌套时，内层当前循环的外层循环</td> 
      </tr> 
     </tbody> 
    </table>
    
     *  给标签增加一个reversed使得该列表被反向迭代:
    
        {% for athlete in athlete_list reversed %}
        ...
        {% empty %}
        ... 如果被迭代的列表是空的或者不存在，执行empty
        {% endfor %}
    
     *  可以嵌套使用\{% for %\}标签：
    
        {% for athlete in athlete_list %}
            <h1>{
             { athlete.name }}</h1>
            <ul>
            <% for sport in athlete.sports_played %>
                <li>{
             { sport }}</li>
            <% endfor %>
            </ul>
        {% endfor %}
3.  **`ifequel/ifnotequal`标签**
    
     *  `{% ifequal %}`标签比较两个值，当他们相等时，显示在`{% ifequal %}`和`{% endifequal %}`之中所有的值。下面的例子比较两个模板变量user和currentuser:
    
        {% ifequal user currentuser %}
            <h1>Welcome!</h1>
        {% endifequal %}
    
     *  和`{% if %}`类似，`{% ifequal %}`支持可选的`{% else %}`标签：
    
        {% ifequal section 'sitenews' %}
            <h1>Site News</h1>
        {% else %}
            <h1>No News Here</h1>
        {% endifequal %}
    
     *  其他标签
        
        1.  **csrf\_token**用于跨站请求伪造保护，防止跨站攻击的。`{% csrf_token %}`
4.  **注释标签**
    
     *  单行注释`{# #}`
     *  多行注释`{% comment %}... {% endcomment %}`
    
        {# 这是一个注释 #}
        {% comment %}
        这是多行注释
        {% endcomment %}
5.  **过滤器**
    
     *  模板过滤器可以在遍历被显示前修改它。
     *  语法 `{ { 变量|过滤器}}`
        
        1.  过滤器使用管道字符`|`,例如`{ { name|lower}}`,`{ { name }}`变量被过滤器lower处理后，文档大写转换文本为小写。
        2.  过滤管道可以被**套接**，一个过滤器管道的输出又可以作为下一个管道的输入。
            
             *  例如`{ { my_list|first|upper }}`,将列表第一个元素并将其转化为大写。
        3.  **过滤器传参**
            
             *  有些过滤器可以传递参数，过滤器的参数跟随冒号之后并且总是以双引号包含。
             *  例如:
                
                1.  `{ {bio|truncatewords:"30"}}`,截取显示变量bio的前30个词。
                2.  `{ { my_list|join:"," }}`,将my\_list的所有元素使用`,`逗号连接起来
     *  其他过滤器
    
    <table> 
     <thead> 
      <tr> 
       <th align="left">过滤器</th> 
       <th align="left">说明</th> 
       <th align="left">举例</th> 
      </tr> 
     </thead> 
     <tbody> 
      <tr> 
       <td align="left"><code>cut</code></td> 
       <td align="left">切掉字符串中的指定字符</td> 
       <td align="left"><code>{ { value|cut:"b"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>lower</code></td> 
       <td align="left">转换为小写</td> 
       <td align="left"></td> 
      </tr> 
      <tr> 
       <td align="left"><code>upper</code></td> 
       <td align="left">转换为大写</td> 
       <td align="left"></td> 
      </tr> 
      <tr> 
       <td align="left"><code>truncatewords</code></td> 
       <td align="left">指定的长度截取字符串</td> 
       <td align="left"><code>{ { bio | truncatewords:"30"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>join</code></td> 
       <td align="left">对序列拼接</td> 
       <td align="left"><code>{ { d.e|join:"//"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>first</code>取序列第一个元素</td> 
       <td align="left"></td> 
       <td align="left"></td> 
      </tr> 
      <tr> 
       <td align="left"><code>last</code></td> 
       <td align="left">取序列最后元素</td> 
       <td align="left"></td> 
      </tr> 
      <tr> 
       <td align="left"><code>yesno</code></td> 
       <td align="left">变量可以是True、False、None<br>yesno的参数给定逗号分隔的三个值，返回3个值中的一个。<br>True对应第一个<br>False对应第二个<br>None对应第三个<br>如果参数只有2个，None等效False处理</td> 
       <td align="left"><code>{ {value | yesno:"yeah,no,maybe"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>add</code></td> 
       <td align="left">加法，参数是负数就是减法</td> 
       <td align="left">数字加<code>{ {value | add:"100"}}</code><br>列表合并<code>{ {mylist|add:newlist}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>divisibleby</code></td> 
       <td align="left">能否被整除</td> 
       <td align="left"><code>{ {value | divisibleby:"3" }}</code>能被3整除返回True</td> 
      </tr> 
      <tr> 
       <td align="left"><code>addslashes</code></td> 
       <td align="left">在反斜杠、单引号或者双引号前面加上反斜杠</td> 
       <td align="left"><code>{ {value | addslashes }}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>length</code></td> 
       <td align="left">返回变量的长度</td> 
       <td align="left"><code>{% if my_list | length &gt;1 %}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>default</code></td> 
       <td align="left">变量等价False则使用缺省值</td> 
       <td align="left"><code>{ {value | default:"nothing"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>default_if_none</code></td> 
       <td align="left">变量为None使用缺省值</td> 
       <td align="left"><code>{ {value|default_if_none:"nothing"}}</code></td> 
      </tr> 
      <tr> 
       <td align="left"><code>date</code></td> 
       <td align="left">格式化date或者datetime对象</td> 
       <td align="left">实例：<code>{ {my_dict.date|date:'Y n j'}}</code><br>Y 2000年<br>n 1-12月<br>j 1-31日</td> 
      </tr> 
     </tbody> 
    </table>
    
     *  时间的格式字符查看[https://docs.djangoproject.com/en/1.11/ref/templates/builtins/\#date][https_docs.djangoproject.com_en_1.11_ref_templates_builtins_date]
     *  过滤参考[https://docs.djangoproject.com/en/1.11/ref/templates/builtins/\#join][https_docs.djangoproject.com_en_1.11_ref_templates_builtins_join]

### 模板实例 ###

1.  奇偶行列表输出
    
     *  使用下面字典my\_dict的c的列表，在模板网页中列表ul输出多行数据
        
        1.  要求奇偶行颜色不同
        2.  每行有行号(从1开始)
        3.  列表中所有数据都增大100
    
        from django.http import HttpResponse,HttpRequest,JsonResponse
        from django.template import loader
        from django.shortcuts import  render
        import datetime
        
        def index(request:HttpRequest):
        """视图函数：请求进来返回响应"""
        my_dict = { 
            "a":100,
            "b":0,
            "c":list(range(10,20)),
            "d":'abc',
            "date":datetime.datetime.now()
        }
        context = { "content":"www.xdd.com","my_dict":my_dict}
        return render(request,"index.html",context)
    
     *  模板页面
    
        <!DOCTYPE html>
        <html lang="en">
        <head>
            <meta charset="UTF-8">
            <title>Django web 模板技术</title>
        </head>
        <body>
        我是模板，数据是{
             {content}}
        
        <ul>
        {% for athlete in my_dict.items  %}
            {% ifequal athlete.0 "c" %}
                {% for dt in athlete.1 %}
                    <li>{
             { forloop.parentloop.counter }} | {
             { forloop.counter }} | {
             { athlete.0 }} -- {
             { dt|add:"100" }}</li>
                {% endfor %}
            {% else %}
                {% ifequal athlete.0 "date" %}
                    <li>{
             { forloop.counter }} | {
             { athlete.0 }} -- {
             { athlete.1|date:'Y-n-j' }}</li>
                {% else %}
                    <li>{
             { forloop.counter }} | {
             { athlete.0 }} </li>
                {% endifequal %}
            {% endifequal %}
        {% endfor %}
        </ul>
        </body>
        </html>
    
    ![django4\_004][django4_004]

### 附加–Pycharm模板自定义 ###

1.  第一步：  
    ![django4\_005][django4_005]
2.  第二步  
    ![django4\_006][django4_006]
3.  第三步  
    ![django4\_007][django4_007]

[django4_001]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/ff8ebbde00844e678bee9a2f6426a8b8.jpg
[django4_002]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/53dffdb0e48f4cd784edb230e91906f3.jpg
[django4_003]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/e526770b37bc4b27a90e13bd20cf3c6f.jpg
[https_docs.djangoproject.com_en_2.0_ref_templates_builtins_for]: https://docs.djangoproject.com/en/2.0/ref/templates/builtins/#for
[https_docs.djangoproject.com_en_1.11_ref_templates_builtins_date]: https://docs.djangoproject.com/en/1.11/ref/templates/builtins/#date
[https_docs.djangoproject.com_en_1.11_ref_templates_builtins_join]: https://docs.djangoproject.com/en/1.11/ref/templates/builtins/#join
[django4_004]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/c0e25771cf384a7380be7d55612fcd27.jpg
[django4_005]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/85c51cf1193148f5b6d81200ad8d93a3.jpg
[django4_006]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/fca340587b7e4b5da77758ab6bd5ccb8.jpg
[django4_007]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/76c4e713b65b430197cebdd3bc8a72cf.jpg