npm 包 tmp-highlighter 使用教程

阅读时长 4 分钟读完

前言

在前端开发中,代码高亮展示是很常见的需求,使用第三方库可以方便地实现。本文介绍一款 npm 包 tmp-highlighter,该包提供了一个简单易用的代码高亮工具。本文将对该库的使用教程进行详细介绍。

tmp-highlighter 简介

tmp-highlighter 是一个轻量的语法高亮工具,支持多种语言语法的高亮。该包没有任何依赖,并且使用方便。你只需要将代码字符串和语言信息传递给 tmp-highlighter,即可在页面上展示高亮后的代码。

安装

你可以将 tmp-highlighter 作为 npm 包直接安装:

或者在 HTML 中使用 script 标签引入:

如果选择在 HTML 中使用 script 标签引入,则需要在引入 tmp-highlighter.js 文件后,访问全局变量 tmpHighlighter。

使用

在项目中使用 tmp-highlighter 非常简单,下面是一个基本的使用示例:

-- -------------------- ---- -------
------ -------------- ---- ------------------

----- ---- - -
    -------- ------------ -
        -- -- -- -- -
            ------ --
        - ---- -
            ------ ----------- - -- - ----------- - ---
        -
    -
--

----- ------- - -
  --------- -----
  ----------- ----
--

----- ----------- - ------------------------------ ---------

以上代码先使用 import 引入 tmp-highlighter 包。然后,定义一个 code 变量,包含需要高亮的代码字符串。接着,定义一个 options 变量,构建需要传递给 tmpHighlighter 的选项,包括语言和是否显示行号等。最后,调用 highlight 方法,传递代码字符串和选项参数,得到高亮后的代码字符串。

如果你选择在 HTML 中使用 tmp-highlighter,可以像下面这样使用:

-- -------------------- ---- -------
----- ---- - -
    -------- ------------ -
        -- -- -- -- -
            ------ --
        - ---- -
            ------ ----------- - -- - ----------- - ---
        -
    -
--

----- ------- - -
  --------- -----
  ----------- ----
--

----- ----------- - ------------------------------ ---------

----- --------- - -------------------------------------
------------------- - ------------

在 HTML 中,我们先定义一个容器,然后将高亮后的代码字符串设置为该容器的 innerHTML 值。

选项参数

highlight 方法接受一个选项参数,下面是该参数的默认值:

目前,tmp-highlighter 支持的语言包括:html, css, js, ts, jsx, tsx, json, sql, md, yaml 等。你可以通过将 language 参数设置为其中一个值,来指定要高亮的代码语言。该库支持自定义语言高亮规则,如果是您未支持的语言,您可以通过 tmphl.addLanguage(language, rules) 方法,添加代码高亮规则。

lineNumber 参数用于控制是否显示行号,缺省情况下不显示。

总结

tmp-highlighter 是一个非常简单易用的代码语法高亮工具库。有了它,我们可以方便地实现页面上的代码高亮效果。通过本文,我们了解了该库的使用方法和 options 可选项。希望本文能够帮助你更好地使用和理解 tmp-highlighter。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600560d881e8991b448df1bc

纠错
反馈