前端组件化:模板继承拯救发际线

你是否经历过这样的痛苦:

网站有 20 个页面(首页、列表页、详情页、关于我们...),突然老板说:"把头部导航栏的字号改大一点 "。

如果你还在每个 HTML 文件里复制粘贴 <header>...</header>,那你得改 20 次。万一漏了一个,就是 Bug。


📅 今日知识点:前端组件化思维------模板继承 (extendblock)

核心逻辑:

ThinkCMF 的模板引擎支持类似 Vue/React 的"Layout 布局"概念。

你可以定义一个**"母版文件" (Layout),把头部、底部、CSS/JS 引用都写在这里。其他页面只需要"继承"**这个母版,然后只写自己独特的内容即可。

1. 第一步:打造"母版" (Base Layout)

在你的主题目录(public/themes/your_theme/)下,新建一个文件夹 layout(非强制,为了规范),里面新建 base.html

把所有页面共用的东西都扔进去,用 <block> 标签挖好"坑":

html 复制代码
<!DOCTYPE html>
<html>
<head>
    <title>{$site_info.site_name|default='ThinkCMF'}</title>
    <link href="__TMPL__/assets/css/style.css" rel="stylesheet">
    
    <block name="css"></block>
</head>
<body>

    <header>我是导航栏,改我一个,全站生效!</header>

    <div class="main-container">
        <block name="main">
            这里是默认内容
        </block>
    </div>

    <footer>&copy; 2026 My Website</footer>

    <script src="__STATIC__/js/jquery.js"></script>
    
    <block name="js"></block>
</body>
</html>
2. 第二步:子页面"填坑"

现在写文章详情页 (article.html),你不需要再写 <html><head> 这些东西了。直接继承!

这就像是 Vue 的 Slot(插槽):

html 复制代码
<extend name="layout/base" />

<block name="css">
    <style>
        .article-content { color: #333; }
    </style>
</block>

<block name="main">
    <h1>{$article.post_title}</h1>
    <div class="article-content">
        {$article.post_content}
    </div>
</block>

<block name="js">
    <script>
        console.log("这篇文章的 ID 是 {$article.id}");
    </script>
</block>

💡 前端视角的优势

  1. 修改秒生效 :老板再说改导航栏,你只需要改 base.html 这一次,全站自动同步。
  2. 代码极其干净 :你的业务页面(如 article.html)里只有纯粹的业务代码,没有那些杂乱的 <meta> 标签和 CSS 引用。
  3. 防止冲突 :每个页面的 JS 都在 <block name="js"> 里,页面加载顺序被母版严格控制(通常放在 </body> 之前),不会出现"jQuery 还没加载就报错"的问题。

🧩 补充技巧:小组件用 include

extend 是用来做大布局的,那如果是一个**"侧边栏热门文章"**模块,在很多页面都有,但位置不一样,怎么办?

<include>(类似 Vue 的 Component):

  1. 新建 public/themes/your_theme/public/widget_hot_posts.html
  2. 在里面写好 <portal:articles> 的循环代码。
  3. 在任何页面引入:
html 复制代码
<div class="sidebar">
    <include file="public/widget_hot_posts" />
</div>

🛠️ 今日作业

打开你的主题文件夹,看看 index.htmllist.htmlpage.html 里面是不是重复写了大量的 Header 和 Footer 代码?
动手重构一下吧! 创建一个 base.html,把它们统统收纳起来。你的代码量至少能减少 40%。

今日金句: 不想当架构师的前端不是好切图仔。模板继承就是最基础的"页面架构"。


相关推荐
三十_A7 小时前
零基础通过 Vue 3 实现前端视频录制 —— 从原理到实战
前端·vue.js·音视频
前端小菜袅7 小时前
PC端原样显示移动端页面方案
开发语言·前端·javascript·postcss·px-to-viewport·移动端适配pc端
We་ct7 小时前
LeetCode 228. 汇总区间:解题思路+代码详解
前端·算法·leetcode·typescript
爱问问题的小李8 小时前
ue 动态 Key 导致组件无限重置与 API 重复提交
前端·javascript·vue.js
子兮曰8 小时前
深入Vue 3响应式系统:为什么嵌套对象修改后界面不更新?
前端·javascript·vue.js
CHU7290358 小时前
直播商城APP前端功能全景解析:打造沉浸式互动购物新体验
java·前端·小程序
枫叶丹48 小时前
【Qt开发】Qt界面优化(一)-> Qt样式表(QSS) 背景介绍
开发语言·前端·qt·系统架构
子兮曰14 小时前
OpenClaw入门:从零开始搭建你的私有化AI助手
前端·架构·github
吴仰晖14 小时前
使用github copliot chat的源码学习之Chromium Compositor
前端