Skip to content

运行时 API 示例


TIP

更多关于文档页面的配置,请参阅 配置

本页面演示了 VitePress 提供的一些运行时 API 的用法。

主要的 useData() API 可以用于访问当前页面的站点、主题和页面数据。它适用于 .md.vue 文件:

md
<script setup>
import { useData } from 'vitepress'

const { theme, page, frontmatter } = useData()
</script>

## 结果

### 主题数据
<pre>{{ theme }}</pre>

### 页面数据
<pre>{{ page }}</pre>

### 页面前置数据
<pre>{{ frontmatter }}</pre>

结果

页面数据

主题数据

{
  "nav": [
    {
      "text": "主页",
      "link": "/"
    },
    {
      "text": "页面配置",
      "items": [
        {
          "text": "md语法",
          "link": "/markdown-examples"
        },
        {
          "text": "页面配置参考",
          "link": "/api-examples"
        }
      ]
    }
  ],
  "sidebar": [
    {
      "text": "关于前端开发",
      "link": "/target"
    },
    {
      "text": "JS",
      "items": [
        {
          "text": "js原生",
          "items": [
            {
              "text": "API",
              "items": [
                {
                  "text": "js实现拍摄和录屏功能",
                  "link": "/JS/native/Video/"
                },
                {
                  "text": "js流",
                  "link": "/JS/native/Stream/"
                }
              ],
              "collapsed": true
            },
            {
              "text": "JS(TS) 代码片段",
              "link": "/JS/native/script/"
            }
          ],
          "collapsed": false
        },
        {
          "text": "js库",
          "items": [
            {
              "text": "js动画库",
              "items": [
                {
                  "text": "popmotion",
                  "link": "/JS/lib/Animation/"
                }
              ],
              "collapsed": true
            },
            {
              "text": "ThreeJS 3D模型",
              "items": [
                {
                  "text": "基本概念",
                  "link": "/JS/lib/ThreeJS/"
                },
                {
                  "text": "初始化场景模型",
                  "link": "/JS/lib/ThreeJS/init"
                },
                {
                  "text": "第一个3D场景模型",
                  "link": "/JS/lib/ThreeJS/scene"
                },
                {
                  "text": "几何矩阵",
                  "link": "/JS/lib/ThreeJS/geometry"
                },
                {
                  "text": "ThreeJS 示例",
                  "link": "/JS/lib/ThreeJS/example"
                }
              ],
              "collapsed": true
            },
            {
              "text": "Express",
              "items": [
                {
                  "text": "express 框架",
                  "link": "/JS/lib/Express/"
                },
                {
                  "text": "express 命令行工具",
                  "link": "/JS/lib/Express/express-server"
                }
              ],
              "collapsed": true
            },
            {
              "text": "js爬虫",
              "items": [
                {
                  "text": "爬虫示例",
                  "link": "/JS/lib/Clawler/"
                },
                {
                  "text": "puppeteer",
                  "link": "/JS/lib/Clawler/puppeteer"
                }
              ],
              "collapsed": true
            },
            {
              "text": "http-server",
              "link": "/JS/lib/http-server/"
            },
            {
              "text": "html转markdown",
              "link": "/JS/lib/Turndown/"
            },
            {
              "text": "2d物理引擎",
              "link": "/JS/lib/Matter/"
            },
            {
              "text": "robotjs",
              "link": "/JS/lib/Robotjs/"
            }
          ],
          "collapsed": false
        },
        {
          "text": "Deno",
          "link": "/JS/Deno/"
        }
      ],
      "collapsed": false
    },
    {
      "text": "TS",
      "items": [
        {
          "text": "在任意位置运行ts",
          "link": "/TS/run-TS/"
        }
      ],
      "collapsed": false
    },
    {
      "text": "npm",
      "items": [
        {
          "text": "npm",
          "link": "/npm/"
        },
        {
          "text": "npm发布包",
          "link": "/npm/publish"
        }
      ],
      "collapsed": false
    },
    {
      "text": "vscode插件",
      "items": [
        {
          "text": "vscode插件开发",
          "link": "/vscodeExtensions/"
        },
        {
          "text": "vscode文本编辑API",
          "link": "/vscodeExtensions/textEditor"
        },
        {
          "text": "vscode用户代码片段",
          "link": "/vscodeExtensions/userCode"
        }
      ],
      "collapsed": false
    },
    {
      "text": "docker",
      "items": [
        {
          "text": "docker安装",
          "link": "/docker/"
        },
        {
          "text": "docker基本命令",
          "link": "/docker/command"
        },
        {
          "text": "docker打包网页",
          "link": "/docker/build"
        }
      ],
      "collapsed": false
    },
    {
      "text": "其他",
      "items": [
        {
          "text": "YAML",
          "link": "/other/yaml/"
        },
        {
          "text": "常用的git命令",
          "link": "/other/git/"
        },
        {
          "text": "git修改pr",
          "link": "/other/git/pr"
        },
        {
          "text": "git配置",
          "link": "/other/git/config"
        },
        {
          "text": "常用的unix命令",
          "link": "/other/unix/"
        },
        {
          "text": "XPath",
          "link": "/other/xPath/"
        },
        {
          "text": "更多",
          "link": "/other/more/"
        }
      ],
      "collapsed": false
    }
  ],
  "socialLinks": [
    {
      "icon": "github",
      "link": "https://github.com/I-am-shy/vitepress"
    }
  ],
  "search": {
    "provider": "local"
  },
  "lastUpdated": {
    "text": "最后更新时间",
    "formatOptions": {
      "dateStyle": "short",
      "timeStyle": "short"
    }
  },
  "outline": {
    "level": [
      2,
      4
    ],
    "label": "此页面"
  },
  "docFooter": {
    "prev": "上一页",
    "next": "下一页"
  }
}

页面数据

{
  "title": "运行时 API 示例",
  "description": "",
  "frontmatter": {
    "0": "大",
    "1": "纲",
    "2": ":",
    "3": "深",
    "4": "入"
  },
  "headers": [],
  "relativePath": "api-examples.md",
  "filePath": "api-examples.md",
  "lastUpdated": 1741838264000
}

页面前置数据

{
  "0": "大",
  "1": "纲",
  "2": ":",
  "3": "深",
  "4": "入"
}

更多信息

请查阅运行时 API 的完整列表的文档。