代码块带标题

创建

• 在 Demo\docs-base\.vitepress\theme\style 目录新建一个 vp-code-title.scss 文件

  注意

  使用前，必须先安装 代码组图标 插件 才可以生效。推荐使用pmpm安装

pnpm

cd Demo\docs-base
pnpm add -D vitepress-plugin-group-icons

yarn

yarn add -D vitepress-plugin-group-icons

npm

npm install vitepress-plugin-group-icons

bun

bun add -D vitepress-plugin-group-icons

.
├─ demo
│ ├─ docs-base
│ │ ├─ .vitepress
│ │ │ └─ config.mts
│ │ │ └─ theme
│ │     └─ style
│ │       └─ index.scss
│ │       └─ vp-code-title.scss
│ └─ index.md
└─ node_modules

配置

/* Demo/docs-base/.vitepress/theme/style/vp-code-title.scss */
/* 整体容器样式（带阴影和圆角） */
.vp-code-block-title {
  background-color: var(--vp-code-block-bg);
  margin-bottom: 20px;
  border-radius: 8px;
  box-shadow: 0 10px 30px 0 rgba(0, 0, 0, 0.4); /* 添加阴影 */
  overflow: hidden;
  position: relative; /* 确保小圆点定位 */
}

/* Mac 风格的小圆点，放在容器顶部 */
.vp-code-block-title::before {
  content: "";
  position: absolute;
  top: 12px; /* 圆点距离容器顶部的距离 */
  left: 12px;
  width: 12px;
  height: 12px;
  background-color: #fc625d; /* 红色圆点 */
  border-radius: 50%;
  box-shadow: 20px 0 #fdbc40, 40px 0 #35cd4b; /* 黄色和绿色圆点 */
  z-index: 1;
}

/* 标题栏样式 */
.vp-code-block-title .vp-code-block-title-bar {
  color: var(--vp-c-text-1);
  font-size: 14px;
  font-weight: bold;
}

/* 代码块标题：修正倒角、阴影、边距 */
.vp-code-block-title
  div[class*="language-"].vp-adaptive-theme.line-numbers-mode {
  border-radius: 8px;
  box-shadow: none;
  padding-top: 0px;
  margin-bottom: 0px;
}

/* 代码块标题：隐藏小圆点 */
.vp-code-block-title
  div[class*="language-"].vp-adaptive-theme.line-numbers-mode::before {
  display: none;
}

/* 代码块标题：修正行号位置 */
.vp-code-block-title .line-numbers-mode .line-numbers-wrapper {
  padding-top: 20px;
}

/* 代码块标题：修正行号右侧竖线位置 */
.vp-code-block-title .line-numbers-mode .line-numbers-wrapper::after {
  top: 20px;
  height: calc(100% - 40px);
}

/* 代码块标题（无行号）：修正倒角、阴影、边距 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme {
  border-radius: 8px;
  box-shadow: none;
  padding-top: 0px;
}

/* 代码块标题（无行号）：隐藏小圆点 */
.vp-code-block-title div[class*="language-"].vp-adaptive-theme::before {
  display: none;
}

• 在Demo\docs-base\.vitepress\theme\style\文件中创建index.scss文件，并添加以下内容

@use "./vp-code-title.scss" as *; //代码块标题

引入

• 在Demo\docs-base\.vitepress\theme\index.ts文件中引入以下内容

// 引入Demo\docs-base\.vitepress\theme\style\index.scss全局样式
import "./style/index.scss";