静态页面实现 include 引入公用代码的示例

发布时间 - 2026-01-11 03:23:37    点击率:

一直以来,我司的前端都是用 php 的 include 函数来实现引入 header 、footer 这些公用代码的,就像下面这样:

<!-- index.php -->
 
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
  <?php include('header.php'); ?>
  <div>页面主体部分</div>
  <?php include('footer.php'); ?>
</body>
</html>
<!-- header.php -->
<header>这是头部</header>
<!-- footer.php -->
<footer>这是底部</footer>

直到最近某个项目需要做一个 webapp,是通过 HBuilder 将静态页面打包成 APP,这就让我碰到难题了。

如果是小项目,那就直接手动多复制粘贴几遍,但如果页面较多,复制粘贴的方案明显不靠谱,维护成本也高。

在查了很多资料后,最终确定用 gulp 来解决,具体操作如下:

1、安装 gulp 和 gulp-file-include

首先新建个文件夹,在终端里定位到文件夹的位置,然后进行 npm 初始化

npm init

然后安装 gulp

npm install gulp --save-dev

接着安装 gulp-file-include

npm install gulp-file-include --save-dev

2、新建并配置 gulpfile.js

接着我们手动新建一个 js 文件取名为 gulpfile,并在里面写入如下代码:

var gulp = require('gulp');
var fileinclude = require('gulp-file-include');
 
gulp.task('fileinclude', function () {
  // 适配page中所有文件夹下的所有html,排除page下的include文件夹中html
  gulp.src(['page/**/*.html', '!page/include/**.html'])
    .pipe(fileinclude({
      prefix: '@@',
      basepath: '@file'
    }))
    .pipe(gulp.dest('dist'));
});

3、创建项目目录结构,并添加测试代码

项目的整体目录结构应该是这样

app

 page

  include

   header.html

   footer.html

  index.html

 gulpfile.js

 package.json

然后我们添加测试代码,header.html 和 footer.html 没太多好说的,主要是 index.html 要特别注意引入的方式,代码如下:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
  @@include('include/header.html')
  <div>页面主体部分</div>
  @@include('include/footer.html')
</body>
</html>

4、运行

在终端里敲入以下代码,看执行效果

gulp fileinclude

会发现,多了个 dist 文件夹,里面有一个 index.html 文件,gulp-file-include 已经帮我们把最终编译好的 index.html 文件生成好了。

可能你已经能举一反三了,在 gulpfile.js 里,我们可以手动设置最终生成文件的位置,就是这句话

gulp.dest('dist')

5、自动编译

静态页面引入公用代码的问题已经解决了,但每次编写源 html 后,都要去终端里手动执行下编译操作还是很麻烦,那能不能让文件自动编译呢?答案一定是可以的。

gulp 有个 watch 方法,就是监听文件是否有变动的,我们只需稍微修改下 gulpfile.js 文件,增加一段监听代码,如下:

var gulp = require('gulp');
var fileinclude = require('gulp-file-include');
 
gulp.task('fileinclude', function () {
  // 适配page中所有文件夹下的所有html,排除page下的include文件夹中html
  gulp.src(['page/**/*.html', '!page/include/**.html'])
    .pipe(fileinclude({
      prefix: '@@',
      basepath: '@file'
    }))
    .pipe(gulp.dest('dist'));
});
 
gulp.task('watch', function () {
  gulp.watch('page/**/*.html', ['fileinclude']);
});

写好之后,我们只需在终端里执行

gulp watch

我们每次保存源 html 后,gulp 就会自动帮我们编译一遍。

至此,静态页面如何实现 include 引入公用代码的问题,顺利解决,最后附上相关资料。

以上这篇静态页面实现 include 引入公用代码的示例就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持。


# 静态页面include  # JS实现完美include加载功能代码  # JS 实现完美include载入实现代码  # 这是  # 只需  # 给大家  # 都是  # 就会  # 让我  # 好了  # 太多  # 就像  # 有个  # 那就  # 夹中  # 是这样  # 并在  # 要去  # 一遍  # 我们可以  # 这句话  # 这就  # 希望能 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 北京企业网站设计制作公司,北京铁路集团官方网站?  动图在线制作网站有哪些,滑动动图图集怎么做?  Linux系统命令中tree命令详解  如何在宝塔面板中修改默认建站目录?  Java类加载基本过程详细介绍  ai格式如何转html_将AI设计稿转换为HTML页面流程【页面】  Swift开发中switch语句值绑定模式  C++时间戳转换成日期时间的步骤和示例代码  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  JavaScript如何操作视频_媒体API怎么控制播放  Laravel如何配置和使用缓存?(Redis代码示例)  如何有效防御Web建站篡改攻击?  iOS发送验证码倒计时应用  网站建设要注意的标准 促进网站用户好感度!  在线教育网站制作平台,山西立德教育官网?  Python图片处理进阶教程_Pillow滤镜与图像增强  HTML 中动态设置元素 name 属性的正确语法详解  Java垃圾回收器的方法和原理总结  Laravel如何实现事件和监听器?(Event & Listener实战)  网站页面设计需要考虑到这些问题  PHP的CURL方法curl_setopt()函数案例介绍(抓取网页,POST数据)  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  怎样使用JSON进行数据交换_它有什么限制  PHP正则匹配日期和时间(时间戳转换)的实例代码  html5的keygen标签为什么废弃_替代方案说明【解答】  Laravel怎么在Controller之外的地方验证数据  油猴 教程,油猴搜脚本为什么会网页无法显示?  使用Dockerfile构建java web环境  Laravel Eloquent模型如何创建_Laravel ORM基础之Model创建与使用教程  详解一款开源免费的.NET文档操作组件DocX(.NET组件介绍之一)  Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控  LinuxCD持续部署教程_自动发布与回滚机制  如何确认建站备案号应放置的具体位置?  创业网站制作流程,创业网站可靠吗?  再谈Python中的字符串与字符编码(推荐)  手机钓鱼网站怎么制作视频,怎样拦截钓鱼网站。怎么办?  如何用美橙互联一键搭建多站合一网站?  如何在不使用负向后查找的情况下匹配特定条件前的换行符  谷歌浏览器下载文件时中断怎么办 Google Chrome下载管理修复  Laravel怎么在Blade中安全地输出原始HTML内容  Laravel如何理解并使用服务容器(Service Container)_Laravel依赖注入与容器绑定说明  js实现获取鼠标当前的位置  Laravel如何处理文件下载请求?(Response示例)  如何在建站之星网店版论坛获取技术支持?  如何在万网自助建站平台快速创建网站?  如何用好域名打造高点击率的自主建站?  java中使用zxing批量生成二维码立牌  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  网站制作大概多少钱一个,做一个平台网站大概多少钱?  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱?