前提:需求在前端展示一些数学公式;
结论:根据项目最终选择了KaTeX 的 Vue3 插件 VaTex 进行了前端数学公式的展示;
理由:比MathJax 渲染快 官方文档易读性高;项目只需要展示简单的数学公式;
效果展示:
技术调研:
- 使用 MathML
HTML5 本身支持 MathML(数学标记语言),可以直接用标签生成公式。但是,浏览器的支持有限(特别是在某些版本的 Chrome 中未启用),并且样式可能不够理想。
html
<math>
<msup>
<mi>E</mi>
<mn>2</mn>
</msup>
<mo>=</mo>
<mi>m</mi>
<msup>
<mi>c</mi>
<mn>2</mn>
</msup>
</math>
优缺点:
● 优点:内置 HTML,简单易用。
● 缺点:浏览器兼容性差,样式不够灵活。
-
使用 LaTeX 或 TeX + 渲染库
通过使用 LaTeX/TeX 语法配合前端渲染工具,比如 MathJax 或 KaTeX,可以生成公式。这些库会将数学公式渲染为 HTML 或 SVG。
MathJax 示例:
html<script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script> <div> $$E = mc^2$$ </div>
KaTeX 示例:
html<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.css"> <script src="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.js"></script> <div id="formula"></div> <script> katex.render("E = mc^2", document.getElementById("formula")); </script>
优缺点: ● 优点:支持复杂公式,渲染效果优秀,兼容性好。 ● 缺点:需要引入额外的 JS 库。
-
KaTeX 和 MathJax 是最常用的两个选项。它们都能将 LaTeX 代码转换为漂亮的数学公式,但各有优劣,适合不同的应用场景。
核心原理:
- LaTeX 解析:
两者都接受 LaTeX 格式的输入,将 LaTeX 代码中的数学符号、公式结构等信息解析为一个内部表示。 这个内部表示通常是一个抽象语法树(AST),它准确地描述了公式的结构和各个部分之间的关系。
- 字体和符号映射:
解析后的 AST 会被映射到具体的字体和符号上。它们内置了大量的数学符号字体,可以根据 LaTeX 代码中的命令找到对应的符号。
- 布局和渲染:
根据 AST 中的结构信息,以及预定义的布局规则,计算出每个符号的位置和大小。最终将这些信息转换成 HTML、SVG 或 MathML,以便浏览器能够正确地显示。
关键技术点:● 字体:使用专门的数学字体,如 STIX、Computer Modern
等,以确保符号的正确显示。 通过字体映射,将 LaTeX 命令与字体中的字符对应起来。
● 布局引擎:负责计算公式中各个元素的位置和大小,确保公式的整体布局美观。需要考虑上标、下标、分数、根号等各种数学结构的布局规则。
●浏览器兼容性:为了在不同的浏览器上显示一致的效果,需要考虑不同浏览器对 HTML、SVG 和 MathML 的支持情况。
KaTeX
- 特点:
- 速度快: 渲染速度远快于 MathJax,特别适合需要快速展示大量公式的场景。
- 轻量级: 文件体积小,对页面加载速度影响较小。
- 易于使用: API 简单,上手容易。
- 优势:
- 适用于对性能要求较高的项目,如在线教育平台、技术文档等。
- 适合动态生成数学公式的场景。
- 劣势:
MathJax
- 特点:
- 功能强大: 支持几乎所有 LaTeX 语法,能够渲染极其复杂的数学公式。
- 配置灵活: 提供丰富的配置选项,可以高度自定义公式的样式和行为。
- 社区活跃: 社区庞大,资源丰富,遇到问题更容易找到解决方案。
- 优势:
- 适用于学术论文、教材等需要展示大量复杂数学公式的场景。
- 对 LaTeX 的支持非常全面。
- 劣势:
-
渲染速度较慢,对性能要求较高的项目可能不太适合。
-
文件体积较大,会增加页面加载时间。
-
配置复杂,学习成本较高。
对Vue支持的相关插件:
vue2:vue-mathjax;
vue3:vue-mathjax-next;
-
如何选择?
- 性能优先: 如果对渲染速度和页面加载速度有较高要求,可以选择 KaTeX。
- 功能优先: 如果需要渲染非常复杂的数学公式,或者需要高度自定义公式的样式,可以选择 MathJax。
- 易用性优先: 如果希望快速上手,并且对公式的自定义需求不高,可以选择 KaTeX。
Markdown + Math 支持
某些前端框架(如 VuePress、React + Markdown-it)支持直接在 Markdown 中编写公式。
示例代码:
html
$$
E = mc^2
$$
通过配置 MathJax 或 KaTeX,可以自动渲染公式为 HTML。
总结
如果你追求简单:
● MathML:适合直接生成简单的数学公式。
● KaTeX 或 MathJax:适合复杂公式和现代网页。
如果想要定制化或动态公式:
● Markdown 配合 MathJax/KaTeX 是更灵活的选择。
可根据自己的需求和技术栈选择最合适的方案。