nodejs://实现静态html文件的公共文件包含功能

缘起

使用过php或其他后台语言的朋友们应该知道,对于公共文件,比如html的头部,底部等,可以单独写成一个.php文件。

比如header.php和footer.php,然后用include('header.php')或者require('header.php')包含进来。

当修改了header.php文件之后,所有引入了这个文件的代码,都会自动加载最新的文件。

这样,一个普通网站如果有十个页面,那么我们只需要改动一次就可以令这十个文件的头部效果都改变。

但是,静态的html文件,是没有类似这样公共html包含功能的。

不过,目前的很多打包工具,比如,gulp,webpack等,都具有这样的插件。

但是,如果在某个时候,我们仅仅只是需要这样的一个简单的功能,而不想npm install webpack 安装一整个webpack工具,也不想安装各种晦涩难懂的插件,更不想去进行令人头疼的webpack配置的时候,我们该如何去实现这样的一个需求呢?


准备

这里,仅仅只用nodejs的原生fs文件模块,去实现这样的一个公共文件包含工具。

需要准备的东西有:

1.安装好的nodejs程序

2.编辑器


规定

思路非常简单:

这里,定义文件目录结构如下。

[图片上传失败...(image-f0f796-1553416201164)]

src是源码目录,包含了pages目录,其下是所有的页面文件,里面可能会引用公共文件。common是公共文件目录,包含了header.html和footer.html等文件。

dist是资源目录,用来存放页面include标签被公共文件替换后的实际使用的页面文件资源。

  • index.html文件内容
<!DOCTYPE HTML>
<html>
    <head>
        <title>nodejs 制作html静态公共文件包含工具</title>
        <meta charset="utf8" />
        <style>
            html,body,div{padding:0;border:0;margin:0;box-sizing:border-box;}
            html,body{height:100%;}
            body{display:flex;flex-direction:column;}
            .center-middle{display:flex;justify-content:center;align-items:center;}
            .header{flex:0 0 50px;border-bottom:1px solid #ddd;background-color:#95cfd4;}
            .bodyer{flex:1 1 100%;background-color:#ececec;}
            .footer{flex:0 0 50px;border-top:1px solid #ddd;background-color:#7def40;}
        </style>
    </head>
    <body>
        <include src="./header.html"></include>
        <div class="bodyer center-middle">bodyer</div>
        <include src="./footer.html"></include>
    </body>
</html>

  • header.html文件内容
<div class="header center-middle">header</div>

  • footer.html文件内容
<div class="footer center-middle">footer</div>


思路

1.用nodejs的fs模块的readdirSync同步文件读取函数读取pages目录下的所有文件。

2.遍历每个文件,正则匹配<include src="***.html"></include>语句,读取包含于其中的src属性指定的文件路径,并用此文件内容替换掉当前所匹配的include标签。

3.将替换掉include标签后的新的文件内容,写入到dist资源目录,文件名跟当前pages下的文件名同名。


include.js文件代码

const $Fs = require('fs'); // 引入文件模块
let files = $Fs.readdirSync('./src/pages'); // 读取pages页面文件目录下的html文件
files.forEach((file,index) => { // 遍历获得的所有页面文件
    let old_data = $Fs.readFileSync('./src/pages/' + file,'utf8'); // 读取当前文件的内容
    let new_data = old_data.replace(/\<include.*src="(.*)">.*\<\/include\>/gi,(match,p1,offset,string) => {//查找html文件中include标签
        let inc_data = $Fs.readFileSync('./src/common/' + p1,'utf8'); // p1是第一个括号匹配到的值,也就是include包含的文件路径,读取此公共文件
        return inc_data; // 此回调函数返回的值,将替换正则匹配到的字符串
    });
    $Fs.writeFileSync('./dist/' + file,new_data); //将include标签被替换后新的html内容,写入到dist资源目录的同名file文件中(不存在会自动新建)。
});
console.log('执行成功');


node执行include.js文件

image

此时dist目录下已经生成index.html文件

image

内容如下图所示

image

浏览器打开查看

image

如上所示,仅仅通过nodejs的fs模块,一个静态html公共文件包含打包功能用十行代码便能实现。

不过,很多人肯定也能一眼看出来,此工具的通用性,可扩展性,健壮性都比较差,路径硬编码,合法性判断等都没有做处理。对此,我的回答如下:

  1. 编程是一个创造性的职业,程序员不应该完全被工具左右,造轮子永远是一个值得尝试的行为。
  2. 10行代码,不到1kb的大小,能够基本达到webpack + 插件所能达到的功能,何乐而不为?
  3. 一叶障目,不见泰山,编程思想就是那几行代码所蕴含的思维,路径硬编码,路径合法性等问题,只是边角料而已。

结语

感谢您的观看,如有不足之处,欢迎批评指正。

获取资料👈👈👈

本次给大家推荐一个免费的学习群,里面概括移动应用网站开发,css,html,webpack,vue node angular以及面试资源等。
对web开发技术感兴趣的同学,欢迎加入Q群:👉👉👉147076513👈👈👈,不管你是小白还是大牛我都欢迎,还有大牛整理的一套高效率学习路线和教程与您免费分享,同时每天更新视频资料。
最后,祝大家早日学有所成,拿到满意offer,快速升职加薪,走上人生巅峰。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,135评论 6 514
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,317评论 3 397
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,596评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,481评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,492评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,153评论 1 309
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,737评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,657评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,193评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,276评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,420评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,093评论 5 349
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,783评论 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,262评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,390评论 1 271
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,787评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,427评论 2 359

推荐阅读更多精彩内容

  • 文/小包总。 2018.2.1星期四 复盘97天 一个人走不开,不过因为他不想走开;一个人失约,乃因他...
    首席成长官小包总阅读 200评论 0 0
  • 别人要你做什么 你就做什么 最后会变成苦力 别人需要你时就出现 不需要你时就消失 会慢慢失去自我 有时候 别人要你...
    登泓听香阅读 541评论 0 2
  • 我是属于那种比较慢热的人。很多新生事物,就算我是最先接触到的,最开始也不会花太多的精力去了解它,直到身边的人都渐渐...
    雨若newleaf阅读 126评论 0 1