@cogita/plugin-code-copy 为文章页的 fenced code block 添加复制按钮,提供以下能力:
.rspress-doc pre,不修改 Markdown 源文件;navigator.clipboard,不支持时回退到原生复制命令;aria-label 暴露复制成功、失败状态;MutationObserver 兼容 Rspress 的客户端路由切换和异步渲染;核心层负责补齐默认配置,插件只负责规范化配置并生成 virtual-code-copy-data。enabled: false 时仍生成关闭状态模块,让主题可以安全静态导入。
插件不在构建期解析 Markdown,也不把代码内容写入虚拟模块。主题组件只读取 code 元素的运行时文本,因此复制内容与最终渲染结果保持一致。对于 Rspress 标准代码块,优先保留其原生复制操作,只修改复制按钮的提示文案;插件只增强没有原生复制能力的自定义代码块,并兼容 Rspress 按钮属性异步补全的过程。
data-copy-state 和 aria-label 表达,避免只依赖颜色;