首页/博客/WordPress/WordPress高亮代码插件Pure Highlightjs后台设置帮助文档

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档

2025-08-13
3分钟阅读
2,446

Pure Highlightjs插件介绍

WordPress原生pre代码高亮插件Pure Highlightjs重大更新：升级至Highlight.js v11.11.1版本

WordPress原生pre代码高亮插件Pure Highlightjs重大更新：升级至Highlight.js v11.11.1版本

WordPress原生pre代码高亮插件Pure Highlightjs更新到最近v11.11.1，支持百种语言和几十种样式风格，增加全选和复制代码功能... 查看原文

后台设置

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档 - LikaCloud云计算
插件后台设置

主题选择

  • 白天主题：选择代码块的风格样式，选择后保存，预览。没有做精简，可以选择几十种样式。
  • 夜间主题：需要主题支持根html元素添加dark切换夜间模式的方式才会生效，否则只能用白天主题。

滚动条颜色

需根据选择的主题样式设置滚动条样式，滚动条用的是simplebar，兼容所有主流浏览器，可以应用到全站的需要滚动条的地方，遗憾的是不支持页面body和html屏幕边上的滚动条样式。

注意：插件后台设置的滚动条颜色仅对代码块的滚动条生效。

如网站其他地方需要用simplebar时，打开以下插件目录文件：

//位置 plugins/Pure-Highlightjs/assets/pure-highlight.js
// 根据类名添加simplebar滚动条样式
document
  .querySelectorAll(
    'pre, .a, .b, .c，.com-scrollbar'
  )
  .forEach((el) => {
    el.setAttribute('data-simplebar', '');
  });

以上代码如.a，.b，.c，.com-scrollbar这样将div或者其他元素的类名添加到此处，就会应用到simplebar滚动条，比如：

<!-- 滚动条类最好是添加在这个div -->
<div class="com-scrollbar flex flex-col gap-4">
  <!-- 不建议在这个div添加滚动条类 -->
  <div class="content">
    <span>内容</span>
    <span>内容</span>
    <span>内容</span>
    <span>内容</span>
  </div>
</div>

工具栏颜色设置

因为插件的每个主题风格样式都不一样，所以添加了工具样式颜色设置，如果将颜色直接固定在代码里，对于某些主题样式并不协调，后台可以根据选择的样式来设置工具栏颜色。

工具栏显示模式

  • 始终显示：工具栏会一直显示，不会消失。
  • 鼠标悬停显示：当鼠标放在代码块时，工具栏才会显示，移动端是点击一下代码块才会显示。

工具栏浮动

工具栏是一直都会滑动的，始终会一直显示在视口区域内，页面下滑时跟着下滑，上滑时跟着上滑，视口超过代码块时，回到原位置。

代码块高度

当文章内有很多代码块时，每个代码块的代码又很多行时，?建议设置代码块最大高度（max-height），经典编辑器是输入代码的时候填高度，区块编辑器是用的类名方式。

经典编辑器代码块高度设置

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档 - LikaCloud云计算
经典编辑器插入代码设置代码块最大高度

如图，经典编辑器点击代码按钮插入代码时，默认为380最大高度，可以修改为其他数字，插入代码时最后会默认加一个空行，该代码块没有其他代码时建议删除（?当初小编以为是代码问题，最后为什么会多20px空位置，找了半天原来是插入代码时加的空行，哭?‍♀️），下面为经典编辑器演示，最大高度为300px：

<?php
/**
 * PHP长行代码演示示例
 * 用于测试滚动条效果
 */
 
// 基本变量定义
$testString = "这是一个普通的字符串变量，用于演示PHP的基本语法特性";
$numberValue = 123456;
$arrayData = [
    'name' => '测试数据',
    'type' => '演示',
    'values' => [10, 20, 30, 40, 50]
];
 
// 这是一行很长的代码，包含了多个函数调用和字符串拼接，目的是测试滚动条效果。这里我们模拟一个复杂的数据处理过程，包含字符串操作、数组处理和数学计算等多种操作的组合。这段代码会将多个不同类型的数据进行转换和组合，生成一个复杂的结果字符串。
$longLine1 = "处理结果: " . strtoupper(trim(json_encode(array_merge($arrayData, ['timestamp' => time(), 'random' => rand(1000, 9999), 'status' => 'completed', 'message' => '这是一条很长的消息，用于增加字符串长度，测试滚动效果。这里继续添加一些内容，让这行代码变得足够长，以便在显示时需要滚动条才能完全查看。']), " \t\n\r\0\x0B"))) . " | 计算结果: " . (sqrt(pow($numberValue, 2) + pow($numberValue / 2, 2)) * 1.5) . " | 状态信息: 操作已完成，耗时 " . microtime(true) . " 毫秒，内存使用: " . memory_get_usage() . " 字节";
 
// 另一个长行代码，演示条件判断和函数嵌套的复杂情况
if (strlen($testString) > 10 && is_array($arrayData) && count($arrayData['values']) > 3 && $numberValue > 100000 && strpos($testString, 'PHP') !== false && (time() % 2 == 0)) {
    $longLine2 = "满足所有条件 | 数组信息: " . print_r($arrayData, true) . " | 字符串长度: " . strlen($testString) . " | 随机数: " . rand(1, 1000) . " | 当前时间: " . date('Y-m-d H:i:s') . " | 这是为了测试滚动条而添加的额外内容，继续增加长度直到足够长，确保在大多数编辑器或显示窗口中都需要滚动才能看到完整内容。这里再添加一些文字，让这行代码变得更长一些，以达到测试目的。";
} else {
    $longLine2 = "不满足所有条件的默认值";
}
 
// 函数定义
function processData($input) {
    if (!is_array($input)) {
        return "无效输入: 必须提供数组类型";
    }
    
    // 处理数据的逻辑
    $result = [];
    foreach ($input as $key => $value) {
        $result[strtoupper($key)] = is_string($value) ? strrev($value) : $value;
    }
    
    return $result;
}
 
// 类定义
class DemoClass {
    private $property1;
    protected $property2;
    public $property3;
    
    public function __construct($param1, $param2) {
        $this->property1 = $param1;
        $this->property2 = $param2;
        $this->property3 = "默认值: " . $param1 . " - " . $param2;
    }
    
    public function getCombined() {
        return $this->property1 . "|" . $this->property2 . "|" . $this->property3;
    }
}
 
// 执行演示
echo "PHP长行代码测试演示\n";
echo "=====================\n";
echo "1. 长行字符串1: " . $longLine1 . "\n\n";
echo "2. 长行字符串2: " . $longLine2 . "\n\n";
echo "3. 处理后的数据: " . print_r(processData($arrayData), true) . "\n\n";
 
$demoObj = new DemoClass("参数1", "参数2");
echo "4. 对象信息: " . $demoObj->getCombined() . "\n";
?>

经典编辑器代码块有高度时，工具栏会显示展开折叠按钮。

经典编辑器代码没有高度时

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档 - LikaCloud云计算
无需高度时删除代码区块高度数值
<?php
// 简单的PHP类示例
class Greeting {
    private $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
    
    public function sayHello() {
        return "Hello, " . $this->name . "!";
    }
}
 
$greeter = new Greeting("World");
echo $greeter->sayHello();
?>

经典编辑器没有高度时不会显示展开折叠按钮。

区块编辑器代码块高度设置

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档 - LikaCloud云计算
需要高度时填类名高度

目前就有这几个高度类名：

h-200 {
  max-height: 200px; /*最大高度为200px*/
}
h-300 {
  max-height: 300px; /*最大高度为300px*/
}
h-380 {
  max-height: 380px; /*最大高度为380px*/
}
h-500 {
  max-height: 500px; /*最大高度为500px*/
}

区块编辑器没有像经典编辑器一样手动输入高度，采用的是固定类的方式，?可能是小编刚接触区块编辑器的原因吧，后续看看能不能代码区块工具栏添加一个手动输入高度的功能，演示如下：

<?php
/**
 * PHP长行代码演示示例
 * 用于测试滚动条效果
 */
 
// 基本变量定义
$testString = "这是一个普通的字符串变量，用于演示PHP的基本语法特性";
$numberValue = 123456;
$arrayData = [
    'name' => '测试数据',
    'type' => '演示',
    'values' => [10, 20, 30, 40, 50]
];
 
// 这是一行很长的代码，包含了多个函数调用和字符串拼接，目的是测试滚动条效果。这里我们模拟一个复杂的数据处理过程，包含字符串操作、数组处理和数学计算等多种操作的组合。这段代码会将多个不同类型的数据进行转换和组合，生成一个复杂的结果字符串。
$longLine1 = "处理结果: " . strtoupper(trim(json_encode(array_merge($arrayData, ['timestamp' => time(), 'random' => rand(1000, 9999), 'status' => 'completed', 'message' => '这是一条很长的消息，用于增加字符串长度，测试滚动效果。这里继续添加一些内容，让这行代码变得足够长，以便在显示时需要滚动条才能完全查看。']), " \t\n\r\0\x0B"))) . " | 计算结果: " . (sqrt(pow($numberValue, 2) + pow($numberValue / 2, 2)) * 1.5) . " | 状态信息: 操作已完成，耗时 " . microtime(true) . " 毫秒，内存使用: " . memory_get_usage() . " 字节";
 
// 另一个长行代码，演示条件判断和函数嵌套的复杂情况
if (strlen($testString) > 10 && is_array($arrayData) && count($arrayData['values']) > 3 && $numberValue > 100000 && strpos($testString, 'PHP') !== false && (time() % 2 == 0)) {
    $longLine2 = "满足所有条件 | 数组信息: " . print_r($arrayData, true) . " | 字符串长度: " . strlen($testString) . " | 随机数: " . rand(1, 1000) . " | 当前时间: " . date('Y-m-d H:i:s') . " | 这是为了测试滚动条而添加的额外内容，继续增加长度直到足够长，确保在大多数编辑器或显示窗口中都需要滚动才能看到完整内容。这里再添加一些文字，让这行代码变得更长一些，以达到测试目的。";
} else {
    $longLine2 = "不满足所有条件的默认值";
}
 
// 函数定义
function processData($input) {
    if (!is_array($input)) {
        return "无效输入: 必须提供数组类型";
    }
    
    // 处理数据的逻辑
    $result = [];
    foreach ($input as $key => $value) {
        $result[strtoupper($key)] = is_string($value) ? strrev($value) : $value;
    }
    
    return $result;
}
 
// 类定义
class DemoClass {
    private $property1;
    protected $property2;
    public $property3;
    
    public function __construct($param1, $param2) {
        $this->property1 = $param1;
        $this->property2 = $param2;
        $this->property3 = "默认值: " . $param1 . " - " . $param2;
    }
    
    public function getCombined() {
        return $this->property1 . "|" . $this->property2 . "|" . $this->property3;
    }
}
 
// 执行演示
echo "PHP长行代码测试演示\n";
echo "=====================\n";
echo "1. 长行字符串1: " . $longLine1 . "\n\n";
echo "2. 长行字符串2: " . $longLine2 . "\n\n";
echo "3. 处理后的数据: " . print_r(processData($arrayData), true) . "\n\n";
 
$demoObj = new DemoClass("参数1", "参数2");
echo "4. 对象信息: " . $demoObj->getCombined() . "\n";
?>

有高度时，工具栏会显示展开折叠按钮。

区块编辑器代码没有高度时

WordPress高亮代码插件Pure Highlightjs后台设置帮助文档 - LikaCloud云计算
无需高度时类名留空

如果不需要高度或者代码很少的情况下，就不用再设置高度类名，没有高度时，工具栏不会显示展开白折叠按钮，演示如下

<?php
// 简单的PHP类示例
class Greeting {
    private $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
    
    public function sayHello() {
        return "Hello, " . $this->name . "!";
    }
}
 
$greeter = new Greeting("World");
echo $greeter->sayHello();
?>

后续会更新需求更新插件，如插件有什么问题请加QQ群1398231反馈！

标签: