Django模板继承详解

一、什么是Django模板继承

Django的模板继承机制提供了一种高效的方式来构建可复用的页面结构。其核心原理是定义一个基础模板(父模板),然后通过子模板进行扩展或内容覆盖,从而显著减少代码重复。

这种设计遵循DRY原则(Don't Repeat Yourself),既能保持网站整体布局的一致性,又能为各个页面保留定制内容的灵活性。通过这种模块化的管理方式,大大提升了模板维护的效率。

二、父模板

让我们从一个简单的父模板入手。假设有一个名为 base.html 的模板,它定义了网站的基本框架结构:

html 复制代码
​
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}My Website{% endblock %}</title>
</head>
<body>
    <header>
        <h1>Welcome to My Website</h1>
    </header>

    <main>
        {% block content %}
        <!-- 默认内容 -->
        <p>This is the default content.</p>
        {% endblock %}
    </main>

    <footer>
        <p>&copy; 2023 My Website</p>
    </footer>
</body>
</html>

​

该模板通过 {% block %} 标签定义了可覆盖区域,其中 title 和 content 是两个关键块,子模板可通过重写这些块来实现内容自定义。

三、子模板

现在,我们创建一个子模板 home.html,它将继承 base.html 并覆盖其中的特定部分内容。以下是具体实现步骤和示例:

  1. 继承基础模板

    home.html 文件的开头,我们需要使用 {% extends "base.html" %} 标签声明继承关系,这样 Django 模板引擎会先加载 base.html 的框架结构。例如:

    html 复制代码
    {% extends "base.html" %}
  2. 覆盖区块内容
    base.html 中通过 {% block block_name %}, {% endblock %} 定义的区块可以在子模板中重新实现。假设基础模板有一个名为 title,content的区块,我们可以这样覆盖它:

    html 复制代码
    {% block title %}Home - My Website{% endblock %}
    
    {% block content %}
    <h2>Home Page</h2>
    <p>Welcome to the home page of our website!</p>
    {% endblock %}
  3. 完整示例

    一个典型的 home.html 可能如下:

    html 复制代码
    {% extends "base.html" %}
    
    {% block title %}Home - My Website{% endblock %}
    
    {% block content %}
    <h2>Home Page</h2>
    <p>Welcome to the home page of our website!</p>
    {% endblock %}

通过这种方式,我们可以高效地复用模板代码,同时保持各个页面的灵活性和独特性。

四、输出结果

当渲染 home.html 时,Django会将子模板的内容插入到父模板的相应块中,生成以下HTML:

html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Home - My Website</title>
</head>
<body>
    <header>
        <h1>Welcome to My Website</h1>
    </header>

    <main>
        <h2>Home Page</h2>
        <p>Welcome to the home page of our website!</p>
    </main>

    <footer>
        <p>&copy; 2023 My Website</p>
    </footer>
</body>
</html>
相关推荐
ikun_文5 小时前
Django框架路由Router的使用
python·pycharm·django
我的xiaodoujiao1 天前
Django 基础知识详细图文教程 4-Django 视图定义与使用
开发语言·数据库·后端·测试工具·django·sqlite
2601_962180331 天前
python——Django 框架
开发语言·python·django
2601_962066491 天前
【玩转全栈】----Django模板的继承
数据库·django·sqlite
千里码aicood1 天前
Django+Vue 基于XGBoost与随机森林的沿海地区台风天气大数据预警系统实现
vue.js·随机森林·django
可乐鸡翅yeah_2 天前
hls.js 内存泄漏实战排查,直播 M3U8 长时间播放异常定位方案
开发语言·javascript·python·django·ecmascript·m3u8·m3u8在线
可乐鸡翅yeah_2 天前
第三方接口对接 M3U8 流媒体排坑实战,解决外部服务商流兼容难题
前端·javascript·python·django·html·m3u8·m3u8在线
可乐鸡翅yeah_2 天前
个人 / 外包流媒体项目交付实战,M3U8 验收与问题闭环完整工作流
运维·网络·python·低代码·django·m3u8·在线播放
2601_962065252 天前
从零创建一个 Django 项目
后端·python·django
千里码aicood2 天前
Django 基于Django的电脑推荐与分析可视化系统设计与实现
python·django·电脑