vue实现pre代码块组件

在做一个文档页面时,我遇到一个高频需求:
后端返回的是 HTML 富文本(v-html 渲染)
里面有 <pre><code></code></pre> 的代码示例
希望有更好的代码块体验:行号、主题色、横向滚动、统一样式
于是我抽了一个公共组件 CodeBlock,并额外提供一个函数给富文本场景做相关处理,把原生pre > code自动转成同一套 UI 结构。

效果

  • 支持 行号
  • 支持 主题切换:default / dark / blue / green
  • 支持 自定义覆盖颜色
  • 支持普通页面直接 <CodeBlock />使用
  • 支持富文本v-html场景自动装饰(保持一致样式)

目录结构

src/components/CodeBlock/
├─ index.vue
├─ themes.ts
└─ decorateArticleCodeBlocks.ts

主题定义:themes.ts

export type CodeBlockThemeId = "default" | "dark" | "blue" | "green";

export interface CodeBlockThemePalette {
  backgroundColor: string;
  borderColor: string;
  textColor: string;
  gutterColor: string;
  gutterBorderColor: string;
}

export const CODE_BLOCK_THEMES: Record<CodeBlockThemeId, CodeBlockThemePalette> = {
  default: {
    backgroundColor: "#f6f8fa",
    borderColor: "#e8eaed",
    textColor: "#1a1a1a",
    gutterColor: "#8c959f",
    gutterBorderColor: "#e1e4e8",
  },
  dark: {
    backgroundColor: "#1e1e1e",
    borderColor: "#3c3c3c",
    textColor: "#d4d4d4",
    gutterColor: "#858585",
    gutterBorderColor: "#3c3c3c",
  },
  blue: {
    backgroundColor: "#f0f7ff",
    borderColor: "#c8e1ff",
    textColor: "#1a1a1a",
    gutterColor: "#6b7c93",
    gutterBorderColor: "#b8d4f0",
  },
  green: {
    backgroundColor: "#f6faf6",
    borderColor: "#d8ead8",
    textColor: "#1a1a1a",
    gutterColor: "#6b8f6b",
    gutterBorderColor: "#c8dcc8",
  },
};

export function getCodeBlockThemePalette(theme: CodeBlockThemeId): CodeBlockThemePalette {
  return CODE_BLOCK_THEMES[theme] ?? CODE_BLOCK_THEMES.default;
}

组件实现:index.vue

<template>
  <pre
    class="cd-code-block"
    :class="[{ 'cd-code-block--numbered': showLineNumbers }, languageClass]"
    :data-theme="theme"
    :style="preStyle"
  >
    <span
      v-if="showLineNumbers"
      class="cd-code-block__gutter"
      aria-hidden="true"
      :style="gutterStyle"
    >{{ gutterText }}</span>
    <code class="cd-code-block__code" :class="codeClass">{{ content }}</code>
  </pre>
</template>

<script setup lang="ts">
import { computed } from "vue";
import { type CodeBlockThemeId, getCodeBlockThemePalette, type CodeBlockThemePalette } from "./themes";

const props = withDefaults(
  defineProps<{
    content: string;
    theme?: CodeBlockThemeId;
    showLineNumbers?: boolean;
    backgroundColor?: string;
    borderColor?: string;
    gutterColor?: string;
    gutterBorderColor?: string;
    textColor?: string;
    languageClass?: string;
    codeClass?: string;
  }>(),
  {
    theme: "default",
    showLineNumbers: true,
    languageClass: "",
    codeClass: "",
  }
);

const palette = computed((): CodeBlockThemePalette => {
  const base = getCodeBlockThemePalette(props.theme);
  return {
    backgroundColor: props.backgroundColor ?? base.backgroundColor,
    borderColor: props.borderColor ?? base.borderColor,
    textColor: props.textColor ?? base.textColor,
    gutterColor: props.gutterColor ?? base.gutterColor,
    gutterBorderColor: props.gutterBorderColor ?? base.gutterBorderColor,
  };
});

const lineCount = computed(() => Math.max(props.content.split(/\n/).length, 1));
const gutterText = computed(() =>
  Array.from({ length: lineCount.value }, (_, i) => String(i + 1)).join("\n")
);

const gutterStyle = computed(() => ({
  minWidth: `${String(lineCount.value).length + 0.5}ch`,
  color: palette.value.gutterColor,
  borderRight: `1px solid ${palette.value.gutterBorderColor}`,
}));

const preStyle = computed(() => ({
  backgroundColor: palette.value.backgroundColor,
  border: `1px solid ${palette.value.borderColor}`,
  color: palette.value.textColor,
}));
</script>

<style lang="less">
.cd-code-block {
  box-sizing: border-box;
  margin: 12px 0;
  padding: 14px 16px;
  font-size: 13px;
  line-height: 1.55;
  border-radius: 8px;
  -webkit-overflow-scrolling: touch;
}
.cd-code-block:not(.cd-code-block--numbered) { overflow-x: auto; }

.cd-code-block--numbered {
  display: flex;
  align-items: stretch;
  padding: 12px 14px 12px 12px;
}

.cd-code-block__gutter {
  flex: 0 0 auto;
  padding-right: 12px;
  margin-right: 12px;
  text-align: right;
  user-select: none;
  white-space: pre;
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  border-right: 1px solid #e1e4e8;
}

.cd-code-block__code {
  display: block;
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  white-space: pre;
  word-break: normal;
  overflow-wrap: normal;
  background: transparent;
}
.cd-code-block--numbered .cd-code-block__code {
  flex: 1 1 auto;
  min-width: 0;
  overflow-x: auto;
}
</style>

富文本场景支持:decorateArticleCodeBlocks.ts

  • 当你只能用 v-html 渲染后端 HTML 时,这个函数很有用。
import { type CodeBlockThemeId, getCodeBlockThemePalette } from "./themes";

export interface DecorateArticleCodeBlocksOptions {
  theme?: CodeBlockThemeId;
  backgroundColor?: string;
  borderColor?: string;
  textColor?: string;
  gutterColor?: string;
  gutterBorderColor?: string;
}

export function decorateArticleCodeBlocks(root: HTMLElement | null, options?: DecorateArticleCodeBlocksOptions) {
  if (!root) return;

  const base = getCodeBlockThemePalette(options?.theme ?? "default");
  const colors = {
    backgroundColor: options?.backgroundColor ?? base.backgroundColor,
    borderColor: options?.borderColor ?? base.borderColor,
    textColor: options?.textColor ?? base.textColor,
    gutterColor: options?.gutterColor ?? base.gutterColor,
    gutterBorderColor: options?.gutterBorderColor ?? base.gutterBorderColor,
  };

  root.querySelectorAll("pre").forEach((preEl) => {
    const pre = preEl as HTMLPreElement;
    if (pre.dataset.lineNumbersApplied === "1") return;

    const code = pre.querySelector(":scope > code");
    if (!code) return;

    const raw = code.textContent ?? "";
    const lineCount = Math.max(raw.split(/\n/).length, 1);
    const gutterText = Array.from({ length: lineCount }, (_, i) => String(i + 1)).join("\n");

    pre.dataset.lineNumbersApplied = "1";
    pre.classList.add("cd-code-block", "cd-code-block--numbered");
    pre.style.backgroundColor = colors.backgroundColor;
    pre.style.border = `1px solid ${colors.borderColor}`;
    pre.style.color = colors.textColor;

    const gutter = document.createElement("span");
    gutter.className = "cd-code-block__gutter";
    gutter.setAttribute("aria-hidden", "true");
    gutter.textContent = gutterText;
    gutter.style.minWidth = `${String(lineCount).length + 0.5}ch`;
    gutter.style.color = colors.gutterColor;
    gutter.style.borderRight = `1px solid ${colors.gutterBorderColor}`;

    const newCode = document.createElement("code");
    newCode.className = `cd-code-block__code ${(code as HTMLElement).className || ""}`.trim();
    newCode.textContent = raw;

    pre.replaceChildren(gutter, newCode);
  });
}

如何使用

  • 普通组件场景
<CodeBlock theme="dark" :content="snippet" language-class="language-bash" />
  • 富文本场景(v-html)
import { nextTick } from "vue";
import "@/components/CodeBlock/index.vue"; // 引入样式
import { decorateArticleCodeBlocks } from "@/components/CodeBlock/decorateArticleCodeBlocks";

await nextTick();
decorateArticleCodeBlocks(containerRef.value, { theme: "default" });

参数说明(简版)

  • content: 代码字符串(必填)

  • theme: default | dark | blue | green

  • showLineNumbers: 是否显示行号

  • backgroundColor / borderColor / textColor / gutterColor / gutterBorderColor: 可覆盖主题颜色

  • languageClass / codeClass: 透传类名,方便和语法高亮库配合

  • 如果页面是后端富文本,建议统一走 decorateArticleCodeBlocks,能保持视觉一致。

  • 如果是前端自渲染文档,直接用<CodeBlock />更清晰。

  • 主题优先走 theme,只在品牌风格要求时做单项覆盖。

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容