构建基于 NodeJS 的 LESS.js 预编译 CSS 服务

简介: 我们在项目中使用 Less.js 的预编译 css 技术。Less 最终编译的代码是 css,也就是 *.less 输出 *.css 的工作,围绕这项过程的方式方法多种多样,有的是导入 less.js 到页面编译 less(客户端执行),有的是透过构建工具如 Grunt、Glup 生成。

我们在项目中使用 Less.js 的预编译 css 技术。Less 最终编译的代码是 css,也就是 *.less 输出 *.css 的工作,围绕这项过程的方式方法多种多样,有的是导入 less.js 到页面编译 less(客户端执行),有的是透过构建工具如 Grunt、Glup 生成。客户端执行比较耗时而且也有浏览器兼容的问题,故不推荐;构建工具比较流行于前端社区,如果放在 JEE 项目中似乎太重了,不便于 Javaer 学习跟使用。我们想,既然 less 是 js 编写的编译器,其官方也有提供跟 nodejs 对接 npm 包,那干脆通过 nodejs 搭建一个 web 服务器,接收到请求就返回编译好 css 便完事。

页面上通过 link 标签导入 node 运行着的服务,返回由参数所指定的 less 文件-->css 文件。如下例子如是:

<link rel="Stylesheet" type="text/css" href="http://192.168.1.92/lessService/?isdebug=true&ns=C:/work/eclipse/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/yuetv_wap/asset/less&lessFile=C:/work/eclipse/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/yuetv_wap/asset/less/yuetv_wap.less&picPath=http://localhost:8080/yuetv_wap/asset/images/1/&MainDomain=http://192.168.1.92:8080/yuetv_wap" />

其中 url 如:http://192.168.1.92/lessService/?isdebug=true&ns=C:/work/eclipse/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/yuetv_wap/asset/less&lessFile=C:/work/eclipse/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/yuetv_wap/asset/less/yuetv_wap.less&picPath=http://localhost:8080/yuetv_wap/asset/images/1/&MainDomain=http://192.168.1.92:8080/yuetv_wap

请求的参数应按如下表传参:

参数名 是否必传 含义
lessFile y LESS 文件位置,就是要解析的 LESS 文件名全称
ns n 参数 ns =namespace 为命名空间之目录名,LESS 会在此目录下自动加入 LESS 而无须加上 目录前缀。通常为项目的 LESS 总目录,该目录下有多个 LESS 文件
picPath n 参数 picPath 是背景图的所在目录。开发阶段和线上的部署阶段的目录会有所不同
isdebug n 参数 isDebug = true 为调试阶段,不压缩 css 输出;当 isDebug = false 时候,压缩输出

通过上述介绍大家应该明白这是一种什么思路了。好接着我们需要一个 nodejs 环境,而且安装 less.js NPM 包。NPM 下载:

npm install less (https://www.npmjs.com/package/less)

OR

下载我提供的 js 包,内置了 less.js 包完整依赖。(稍后提供)

光有包不够,真正把 less 服务暴露到 web 还是下面 js 脚本。下载下面 js。

  • http://git.oschina.net/sp42/ajaxjs/blob/master/nodejs/less-parser.js?dir=0&filepath=nodejs%2Fless-parser.js
  • http://git.oschina.net/sp42/ajaxjs/blob/master/nodejs/lib/step.js?dir=0&filepath=nodejs%2Flib%2Fstep.js
  • http://git.oschina.net/sp42/ajaxjs/blob/master/nodejs/lib/webserver-utils.js?dir=0&filepath=nodejs%2Flib%2Fwebserver-utils.js

首先我们要让 nodejs 跑起 web 服务来,这是 nodejs 强项,仅次于 hello world 用法:

const HTTP = require('http'), less = require('less'), fs = require('fs'), Step = require('./lib/step'), webUtils = require('./lib/webserver-utils');

const port = 80, base_less_folder = 'c:/project/ajaxjs/less',
server = HTTP.createServer((req, res) => {
	init(req, res);
});

server.listen(port, null, () => {
	var host = '';
	console.log(`Image Server running at http://${host}:${port}/`);
});

这里是 80 端口,需要的话就修改吧。还有个 base_less_folder 配置你也可以修改,是关于 less 读取的目录,也就是上述 ns 参数。当前默认有一个,然而可以通过 url 参数陆续添加。

真正处理转换的是 init 函数:

init = function (request, response) {
	console.log('Current Less.js vresion:' + less.version.join('.'));
	
	var _req = webUtils.url2json(request.url),
		lessFile = _req.lessFile,
		ns = _req.ns; // 读取 url 的命名空间


	if (!lessFile) 
		return webUtils.show500error(response, '未发行对应的样式文件!');

	// 指定包空间

	var ns_arr = [
	            base_less_folder
    ];
	
	ns && ns_arr.push(ns);

	// 背景图的路径按 CSS 为基准。但因为 CSS 处于 Node 服务器上,所以要指定到 Tomcat 上才行。

	var assetFilePath = '@assetFilePath: "http://localhost:8080/sport/asset/images";\n';
	var assetFilePath = '@assetFilePath: "' + _req.picPath + '";\n';

	Step(function () {
		console.log('请求 LESS 命名空间:' + lessFile.split('/').pop());
		fs.readFile(lessFile, "utf8", this);
	}, function (err, lessFile) {
		if (err) 
			return webUtils.show500error(response, '未发行对应的样式文件!原因:' + err.toString());
		
		var isDebug = _req.isdebug; // 是否压缩样式 


		
		try {
			less.render(assetFilePath + lessFile, {
				paths: ns_arr,
				compress: (!isDebug || isDebug == 'false')
			}, this);
		} catch (e) {
			return webUtils.show500error(response, 'LESS 解析 less 失败,请检查 LESS 文件是否写错!原因:' + e);
		}
	}, function (err, tree) {
		if (err) 
			return webUtils.show500error(response, 'LESS 解析 less 失败!原因:' + err);
		
		response.writeHead(200, { 'Content-Type': 'text/css; charset=UTF-8' });

		var isDebug = _req.isdebug; // 是否压缩样式


		response.end(tree.css);
		
		if (!isDebug || isDebug == 'false') {}
		else if (isDebug == 'true') { }

		// 总是 localhost/app 后面有一个 app 项目名

		// deployUsed = deployUsed.replace(/http:\/\/localhost:8080\/\w+/i, _req.MainDomain);

		// console.log('--------' + tree);

		console.log('--------' + _req.picPath);
		var deployUsed = tree.css.replace(new RegExp(_req.picPath, 'g'), '../images');

		// 保存文件在父级 css 目录下,save to file

		// toCSS(lessFile.replace(/(.*?\/)(\w+)\.less/, '$1../css/$2.css'), deployUsed);

	});
}

这里使用了 step.js 避免 callback hell 问题和封装了相关 web 的方法。

值得注意的是,这一系列过程都是开发环境用的。如果生成环境就是得 css 读取了。我们的后台会自动识别,如果开发的时候就走 less/node 的,生产环境就 css。

怎么让生产环境读到 css 呢?一个笨方法就是手工 copy 导出的再保存,另外一种方法就是上面脚本 倒数第三行的,自动把得到的 css 保存起来,这样就不用手工拷贝了。

目录
相关文章
|
7天前
|
JavaScript 前端开发 持续交付
【专栏】构建现代Web应用:Vue.js与Node.js的完美结合
【4月更文挑战第27天】本文探讨了Vue.js和Node.js如何结合构建现代Web应用。Vue.js作为轻量级前端框架,以其简洁易懂、组件化开发、双向数据绑定和虚拟DOM等特点受到青睐;而Node.js是高性能后端平台,具备事件驱动、非阻塞I/O、丰富生态系统和跨平台优势。两者结合实现前后端分离,高效通信,并支持热更新、持续集成、跨平台和多端适配,为开发高性能、易维护的Web应用提供强有力的支持。
|
4天前
|
前端开发 测试技术 定位技术
【专栏:HTML 与 CSS 实战项目篇】构建一个企业级网站:HTML 与 CSS 实战
【4月更文挑战第30天】本文介绍了使用HTML和CSS构建企业级网站的实战步骤,包括项目概述、页面结构设计、HTML结构搭建、CSS样式设计、具体页面实现、优化与提升。通过合理布局、美观样式和响应式设计,创建现代、简洁的网站,包含主页、关于我们、产品展示、新闻动态和联系我们等页面。优化图片和代码,确保性能,助力企业在数字时代树立良好形象并提升沟通效率。
|
4天前
|
前端开发 搜索推荐 SEO
【专栏:HTML 与 CSS 实践篇】使用 HTML 与 CSS 构建个人博客网站
【4月更文挑战第30天】本文介绍了使用HTML和CSS构建个性化个人博客网站的步骤。首先,规划设计网站主题、风格和结构;接着,利用HTML搭建首页、文章列表页和文章详情页的结构;然后,通过CSS设计整体风格、布局和交互效果;填充内容并进行SEO优化;最后,通过实际案例展示HTML和CSS的应用。构建博客网站不仅是展示自我和分享知识的平台,也是提升技能和创意实践的好机会。
|
4天前
|
开发框架 前端开发 搜索推荐
标题:【专栏:CSS进阶篇】CSS样式重置与框架:快速构建统一风格的网页
【4月更文挑战第30天】本文探讨了CSS样式重置和框架在确保网页跨浏览器一致性中的作用。样式重置通过消除默认样式差异实现一致外观,而CSS框架如Bootstrap提供预设样式和组件,加速开发并保证页面一致性。框架还有响应式设计和易于维护的优点,但也可能限制自定义和增加性能开销。选择使用哪种工具应根据项目需求、团队技能和设计复杂度来决定。开发者可结合使用两者以平衡灵活性和控制。
|
4天前
|
前端开发 UED 容器
【专栏:CSS进阶篇】CSS Grid布局:构建复杂的二维布局
【4月更文挑战第30天】CSS Grid布局是二维布局系统,适用于复杂页面结构,如页眉、主体和侧边栏。通过定义网格线和单元格,能轻松创建行和列。基本语法包括设置容器为grid容器,定义`grid-template-rows`和`grid-template-columns`。高级特性包括命名网格线、网格区域、网格间隙、重复网格线和自动填充。在实际应用中,CSS Grid能有效提升开发效率和用户体验,尤其在响应式设计和复杂布局场景下。
|
4天前
|
JavaScript 前端开发 API
如何利用JavaScript和Electron构建具有丰富功能的桌面应用
【4月更文挑战第30天】如何利用JavaScript和Electron构建具有丰富功能的桌面应用
4 0
|
5天前
|
缓存 监控 JavaScript
Node.js中构建RESTful API的最佳实践
【4月更文挑战第30天】本文介绍了在Node.js中构建RESTful API的最佳实践:选择合适的框架(如Express、Koa)、设计清晰的API接口(遵循HTTP动词和资源路径)、实现认证授权(JWT、OAuth 2.0)、错误处理、限流缓存、编写文档和测试,以及监控性能优化。这些实践有助于创建健壮、可维护和易用的API。
|
5天前
|
消息中间件 监控 JavaScript
Node.js中的微服务架构:构建与实践
【4月更文挑战第30天】本文探讨了在Node.js中构建微服务的实践,包括定义服务边界、选择框架(如Express、Koa或NestJS)、设计RESTful API、实现服务间通信(HTTP、gRPC、消息队列)、错误处理、服务发现与负载均衡,以及监控和日志记录。微服务架构能提升应用的可伸缩性、灵活性和可维护性。
|
5天前
|
JavaScript API 开发者
深入了解Node.js的文件系统:Node.js文件系统API的使用与探索
【4月更文挑战第30天】本文深入探讨了Node.js的文件系统API,介绍了如何引入`fs`模块进行文件操作。内容包括异步读取和写入文件、删除文件、创建目录以及使用文件流进行高效操作。此外,还提到了文件系统的监视功能,帮助开发者全面掌握在Node.js中处理文件和目录的方法。
|
9天前
|
前端开发 JavaScript
前端 富文本编辑器原理——从javascript、html、css开始入门(二)
前端 富文本编辑器原理——从javascript、html、css开始入门
21 0
前端 富文本编辑器原理——从javascript、html、css开始入门(二)