type
status
date
slug
summary
tags
category
icon
password
URL
url
全文摘要
react-notion-x 是一个快速准确的 React 渲染器,用于展示 Notion 页面内容。它提供了 TypeScript 支持,并且与 Next.js、create-react-app、Gatsby 等框架兼容。该库支持多种 Notion 块类型和集合视图,具有高性能和优秀的 Lighthouse 评分。此外,它还支持可选组件的延迟加载,以保持初始页面包的轻量级。
特点
- 项目特点: react-notion-x 提供了简单、快速、高测试覆盖率的 Notion 页面渲染方案,支持 TypeScript 并兼容多种 React 框架。
- 使用指南: 开发者首先需要通过 NotionAPI 获取页面数据,然后使用 NotionRenderer 组件渲染页面内容。
- 样式指南: 为确保页面正确显示,需要导入核心 CSS 样式,还可以根据需要导入代码高亮和公式渲染的样式。
- 可选组件: 库默认不包含一些较大的组件,如 PDF 预览和集合视图,这些可以通过动态导入的方式按需加载。
- 私有页面访问: 可以通过传递 authToken 和 activeUser 访问私有 Notion 页面,这些信息可以从浏览器的 Cookie 中获取。
- Next.js 示例: 提供了 Next.js 示例项目,展示了如何在页面中使用 react-notion-x 进行渲染。
- 性能优化: react-notion-x 支持图片懒加载和低质量图片占位符预览,以及使用 CDN 进行缓存以提高加载速度。
- 支持的块类型: 库支持大多数 Notion 块类型和集合视图,但某些特定视图如日历视图尚未支持。
- 作者:notion2go
- 链接:https://notion2go.com/article/React-Notion-X
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。