静态页面实现 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


相关推荐: 如何在浏览器中启用Flash_2025年继续使用Flash Player的方法【过时】  Laravel如何使用API Resources格式化JSON响应_Laravel数据资源封装与格式化输出  如何在Windows 2008云服务器安全搭建网站?  Laravel如何使用软删除(Soft Deletes)功能_Eloquent软删除与数据恢复方法  网页设计与网站制作内容,怎样注册网站?  如何为不同团队 ID 动态生成多个独立按钮  成都品牌网站制作公司,成都营业执照年报网上怎么办理?  青岛网站建设如何选择本地服务器?  Laravel如何使用集合(Collections)进行数据处理_Laravel Collection常用方法与技巧  HTML 中如何正确使用模板变量为元素的 name 属性赋值  做企业网站制作流程,企业网站制作基本流程有哪些?  Laravel如何实现本地化和多语言支持_Laravel多语言配置与翻译文件管理  Laravel如何使用Guzzle调用外部接口_Laravel发起HTTP请求与JSON数据解析【详解】  linux写shell需要注意的问题(必看)  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  开心动漫网站制作软件下载,十分开心动画为何停播?  高防网站服务器:DDoS防御与BGP线路的AI智能防护方案  Angular 表单中正确绑定输入值以确保提交与验证正常工作  Laravel如何实现用户角色和权限系统_Laravel角色权限管理机制  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  东莞专业网站制作公司有哪些,东莞招聘网站哪个好?  Laravel distinct去重查询_Laravel Eloquent去重方法  微信小程序 wx.uploadFile无法上传解决办法  Laravel如何实现API版本控制_Laravel版本化API设计方案  深入理解Android中的xmlns:tools属性  如何在 Python 中将列表项按字母顺序编号(a.、b.、c. …)  Laravel如何创建自定义Artisan命令?(代码示例)  香港服务器网站推广:SEO优化与外贸独立站搭建策略  Laravel如何集成Inertia.js与Vue/React?(安装配置)  JavaScript常见的五种数组去重的方式  如何在万网自助建站中设置域名及备案?  Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】  Laravel如何使用Service Provider注册服务_Laravel服务提供者配置与加载  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  Win11搜索栏无法输入_解决Win11开始菜单搜索没反应问题【技巧】  进行网站优化必须要坚持的四大原则  历史网站制作软件,华为如何找回被删除的网站?  如何快速生成可下载的建站源码工具?  东莞市网站制作公司有哪些,东莞找工作用什么网站好?  Android okhttputils现在进度显示实例代码  大型企业网站制作流程,做网站需要注册公司吗?  如何快速上传自定义模板至建站之星?  如何在企业微信快速生成手机电脑官网?  PHP的CURL方法curl_setopt()函数案例介绍(抓取网页,POST数据)  Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】  标题:Vue + Vuex 项目中正确使用 JWT 进行身份认证的实践指南  英语简历制作免费网站推荐,如何将简历翻译成英文?  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做?  如何用AI一键生成爆款短视频文案?小红书AI文案写作指令【教程】