994 字
5 分钟
Expressive Code 代码块

本文展示基于 Expressive Code 的代码块效果。示例参考官方文档,可查阅其了解更多细节。

语法高亮#

语法高亮

常规高亮#

console.log('这段代码会被语法高亮')

渲染 ANSI 转义序列#

Terminal window
ANSI colors:
- Regular: Red Green Yellow Blue Magenta Cyan
- Bold: Red Green Yellow Blue Magenta Cyan
- Dimmed: Red Green Yellow Blue Magenta Cyan
256 colors (showing colors 160-177):
160 161 162 163 164 165
166 167 168 169 170 171
172 173 174 175 176 177
Full RGB colors:
ForestGreen - RGB(34, 139, 34)
Text formatting: Bold Dimmed Italic Underline

编辑器与终端框架#

编辑器与终端框架

代码编辑器框架#

my-test-file.js
console.log('标题属性示例')

src/content/index.html
<div>文件名注释示例</div>

终端框架#

Terminal window
echo "这个终端框架没有标题"

PowerShell 终端示例
Write-Output "这个有标题!"

覆盖框架类型#

echo "看,没有外框!"

PowerShell Profile.ps1
# 不覆盖的话,这本该是终端框架
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
New-Alias tail Watch-Tail

文本与行标记#

文本与行标记

标记整行与行范围#

// 第 1 行 - 按行号标记
// 第 2 行
// 第 3 行
// 第 4 行 - 按行号标记
// 第 5 行
// 第 6 行
// 第 7 行 - 按范围 "7-8" 标记
// 第 8 行 - 按范围 "7-8" 标记

选择行标记类型(mark、ins、del)#

line-markers.js
function demo() {
console.log('这行被标记为删除')
// 本行和下一行被标记为新增
console.log('这是第二行新增')
return '这行使用默认的中性标记类型'
}

给行标记加标签#

labeled-line-markers.jsx
<button
role="button"
{...props}
value={value}
className={buttonClassName}
disabled={disabled}
active={active}
>
{children &&
!active &&
(typeof children === 'string' ? <span>{children}</span> : children)}
</button>

在独立行上放长标签#

labeled-line-markers.jsx
<button
role="button"
{...props}
value={value}
className={buttonClassName}
disabled={disabled}
active={active}
>
{children &&
!active &&
(typeof children === 'string' ? <span>{children}</span> : children)}
</button>

使用 diff 风格语法#

这行会被标记为新增
这行会被标记为删除
这是普通的一行

--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
+这是一个真实的 diff 文件
-所有内容都保持不变
空白也不会被移除

diff 语法 + 语法高亮组合#

function thisIsJavaScript() {
// 整个块按 JavaScript 高亮,
// 同时还能加 diff 标记!
console.log('要移除的旧代码')
console.log('闪亮的新代码!')
}

标记行内特定文本#

function demo() {
// 标记行内任意给定文本
return '支持匹配多处相同文本';
}

正则表达式#

console.log('单词 yes 和 yep 都会被标记。')

转义正斜杠#

Terminal window
echo "Test" > /home/test.txt

选择行内标记类型(mark、ins、del)#

function demo() {
console.log('这里有 inserted 和 deleted 两种标记类型');
// return 语句用默认标记类型
return true;
}

自动换行#

自动换行

按块配置换行#

// 开启换行的示例
function getLongString() {
return '这是一个非常长的字符串,除非容器极宽否则很可能放不下可用空间'
}

// 关闭换行的示例
function getLongString() {
return '这是一个非常长的字符串,除非容器极宽否则很可能放不下可用空间'
}

配置换行缩进#

// preserveIndent 示例(默认开启)
function getLongString() {
return '这是一个非常长的字符串,除非容器极宽否则很可能放不下可用空间'
}

// preserveIndent=false 示例
function getLongString() {
return '这是一个非常长的字符串,除非容器极宽否则很可能放不下可用空间'
}

可折叠区域#

可折叠区域

5 collapsed lines
// 这些样板初始化代码会被折叠
import { someBoilerplateEngine } from '@example/some-boilerplate'
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
const engine = someBoilerplateEngine(evenMoreBoilerplate())
// 这部分默认可见
engine.doSomething(1, 2, 3, calcFn)
function calcFn() {
// 可以有多个折叠区域
3 collapsed lines
const a = 1
const b = 2
const c = a + b
// 这行保持可见
console.log(`计算结果: ${a} + ${b} = ${c}`)
return c
}
4 collapsed lines
// 从这里到块尾的代码会再次折叠
engine.closeConnection()
engine.freeMemory()
engine.shutdown({ reason: '样板代码示例结束' })

行号#

行号

按块显示行号#

// 这个代码块会显示行号
console.log('来自第 2 行的问候!')
console.log('我在第 3 行')

// 这个块关闭了行号
console.log('你好?')
console.log('请问我在第几行?')

修改起始行号#

console.log('来自第 5 行的问候!')
console.log('我在第 6 行')

第 15 篇,共 20 篇本文属于系列

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取