当前位置:

首页 > 编程开发 > SyntaxHighlighter Autoloader(自动加载)最优方式

SyntaxHighlighter Autoloader(自动加载)最优方式

SyntaxHighlighter是代码高亮工具,支持多种语言。一次性加载全部语言配置文件影响效率,官方提供shAutoloader.js实现按需加载。通过path函数和autoloader配置,可灵活使用pre或textarea标签展示代码。进一步优化:后端或前端判断页面是否存在代码块,再决定是否加载脚本,实现按需加载。

一、SyntaxHighlighter介绍

代码高亮这事儿,说大不大,说小不小。SyntaxHighlighter 算是一代经典了,专门用来在网页上给代码上色,支持的语言范围相当广——HTML、CSS、Ja vaScript 这些前端基础语种自不必说,C、Ja va 这些后端编程语言也在射程之内。你随便翻翻现在网上很多技术文章里那些带颜色的代码块,背后可能跑的就是它。具体来说,它能加亮的语言包括:C#、CSS、C++、Delphi、Ja va、Ja vaScript、PHP、Python、Ruby、SQL、Visual Basic、XML/HTML……基本上主流语言都覆盖了。

不过话说回来,这工具好用是好用,但有个实际的问题:不同文章里出现的代码语言往往各不相同。如果为了兼容所有情况,一次把全部语言的配置文件都加载进来,页面加载的东西可就太多了。所以,SyntaxHighlighter 官方提供了一个 shAutoloader.js 脚本,专门用来按需加载——这才是真正的高效之道。

二、使用教程

先说第一步,把下载下来的 SyntaxHighlighter 文件解压,然后只保留 Scripts 和 styles 这两个文件夹,其他杂七杂八的可以扔掉。

SyntaxHighlighter Autoloader(自动加载)最优方式

接着是引入样式文件和脚本。在页面的 之间,把 CSS 放进来:

然后在 结束标签的前面,引入 Ja vaScript 文件——这里就有讲究了,既要 shCore.js,也要 shAutoloader.js:



这段脚本里,核心是那个 path() 函数和后面的 autoloader 调用。path 函数的作用说白了就是个路径拼接器——把你传入的语言别名替换成真实脚本地址。autoloader 则负责按需加载,什么语言出现在页面上,就加载对应的 Brush 文件。下面那一堆 defaults 配置项也很关键:gutter 控制是否显示行号,toolbar 决定是否显示工具栏,auto-links 和 quick-code 则分别控制自动链接和代码快速复制功能,根据需求开关就行。

三、使用方法

配置好了,怎么用?有两种主流方式。

方式一:用 pre 标签

//这里是你需要高亮的代码
//python代码

前者是经典写法,直接通过 class 指定语言;后者则是套了一个容器 div,方便统一控制样式。

方式二:用 textarea 标签

textarea 的好处是不会额外处理里面的特殊字符,对于包含大量<、>、&等符号的代码片段来说,更不容易出问题。

四、高级技巧:按需加载

但现实情况是,文章详情页并不总是有代码块。很多页面可能就是纯文字,如果关了 JS 还去加载一堆高亮脚本,那就是浪费带宽了。所以更好的做法是加一个判断:只有当页面上确实存在代码块时,才去加载这些 JS 文件和执行初始化。

如果你用的是类似 ASP.NET MVC 的 Model 框架,可以在视图里这样写:

var isCode = Model.Html.ToString().Contains("

没有框架的话,用 jQuery 判断也完全可以:

if($('div.jb51code').length > 0){
    // 这里放置上面的js文件链接以及js代码。
}

第一种方法是后端判断,在生成页面 HTML 的时候就决定要不要引脚本;第二种是前端判断,页面加载完去检查 DOM 里有没有代码块元素。两种各有适用场景,看你的项目结构选就行。这才是真正做到了“按需加载”,不浪费一丝一毫的资源。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
作者最新文章
编程开发
相关文章 更多
CSS设置透明度的注意事项有哪些?opacity属性详解
CSS设置透明度的注意事项有哪些?opacity属性详解

深入解析CSS中设置透明度的核心属性opacity,剖析子元素继承、事件穿透、层叠上下文等关键注意事项,并提供与rgba、hsla的实用选型对比。

flutter页面传值到后台的方法及示例代码
flutter页面传值到后台的方法及示例代码

flutter页面传值到后台的完整实现方法及示例代码,帮助读者快速掌握相关技术要点。

Java 8至21新特性代码写法对比:Lambda、Record与Switch
Java 8至21新特性代码写法对比:Lambda、Record与Switch

本文通过具体的旧版与新版代码对比,详细剖析Java 8引入的Lambda表达式、Java 14/16引入的Record类,以及Java 12至21逐步演进完善的Switch表达式与模式匹配,展示代码简化路径与避坑要点。

AI智能体开发培训课程学什么及实战内容介绍
AI智能体开发培训课程学什么及实战内容介绍

系统梳理AI智能体开发培训的核心知识模块、技术栈选型与典型实战项目,解析低代码平台与纯代码框架的差异,提供从零构建可落地智能体的完整学习与实施路径。

Java子类未实现抽象方法编译错误修复指南
Java子类未实现抽象方法编译错误修复指南

针对Java开发中常见的“子类未实现抽象方法”编译错误,深入分析报错原因,提供重写实现、声明抽象子类两种标准修复路径,并总结参数签名、访问修饰符等典型避坑要点。

解决PHP递归报错:max_nesting_level限制与内存溢出处理
解决PHP递归报错:max_nesting_level限制与内存溢出处理

遇到PHP递归报错时,不要盲目调大max_nesting_level。本文教你区分Xdebug限制、内存耗尽和正则递归错误,提供代码级的终止条件优化与迭代替代方案,彻底解决栈溢出问题。

PHP递归中static变量与引用传递的常见陷阱及调试
PHP递归中static变量与引用传递的常见陷阱及调试

本文分析PHP递归中static变量导致的状态污染及引用传递引发的共享数据修改问题。提供具体的代码复现、缓存键设计建议及调试打印技巧,帮助开发者避免隐蔽的逻辑错误。

PHP递归性能优化技巧与迭代替代方案
PHP递归性能优化技巧与迭代替代方案

解析PHP递归函数在树形数据处理中的性能瓶颈,提供预加载数据消除I/O、使用显式栈替代深层递归的实战方案,帮助开发者在代码可读性与执行效率间做出合理取舍。

Java测试中怎么使用Mockito模拟依赖对象
Java测试中怎么使用Mockito模拟依赖对象

详细讲解在Java单元测试中如何使用Mockito模拟依赖对象,包括引入依赖、创建Mock、打桩返回值、行为验证以及Mock与Spy的核心差异和常见陷阱排查。

链表删除节点的时间复杂度是多少及其详细分析
链表删除节点的时间复杂度是多少及其详细分析

详细分析链表删除节点的时间复杂度,深入探讨单链表与双向链表在不同已知前提下的查找与删除开销,并结合完整代码与清晰图解进行对比总结。

查看更多
精品专题 更多
装机必备
装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows
Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

macOS软件
macOS软件

正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

Mac软件 更多
photoshop
photoshop
Windows、macOS 、 iPad

Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。

Blender
Blender
Windows、macOS 和 Linux

Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。

灵活计算器
灵活计算器
macOS/iOS/Android

灵活计算器是一款笔记式算数应用,支持实时计算、动态关联和云端同步功能。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

WINDOWS 更多
3dmax(3ds max)
3dmax(3ds max)
Windows

Autodesk 3ds Max 是一款专业的三维建模、动画与渲染软件,广泛应用于建筑可视化、游戏开发、影视动画、广告设计和产品展示等领域。

photoshop
photoshop
Windows、macOS 、 iPad

Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。

Blender
Blender
Windows、macOS 和 Linux

Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。