简体中文
主题
为 VitePress 提供跨框架群岛架构
在 VitePress Markdown 页面里直接导入和渲染 React 组件,保留现有 JSX、TSX 和 TypeScript 工作流。
每个组件都可以单独选择 `ssr:only`、`client:load`、`client:visible` 或 `client:only`,不必把整页改成单独的前端应用。
`spa:sync-render` 可以让特定组件在路由切换时更早落到正确位置,减少闪烁和布局偏移。
站点仍然按 VitePress 的静态生成方式工作,只在确实需要交互的区域补上客户端接管。
React 组件、Markdown 内容和主题扩展继续放在同一条文档工作流里,`HMR` 和构建行为也保持一致。
提供页面浮层、调试日志、包组成视图和构建报告入口,便于定位渲染、`HMR` 和资源体积问题。
Global Debug Console
Browse the runtime globals injected by @docs-islands/vitepress and inspect their current live values.
@docs-islands/vitepress
Console helper: window.__DOCS_ISLANDS_SITE_DEVTOOLS__.getGlobal('__PAGE_METAFILE__')
window.__DOCS_ISLANDS_SITE_DEVTOOLS__.getGlobal('__PAGE_METAFILE__')
Injected Globals