@ frontlit/ 页面构建器
基于块的页面构建器和渲染器用于React. 自成一体——无后端和框架锁定. 主题,块,以及WYSIWYG建设者都运行客户端.
你和你的探员可以在同一页上合作. 人们在WYSIWYG的构建器中进行视觉编辑. AI代理编辑同页数据,即平面JSON(块外加他们的设置),没有涉及截图或浏览器自动化. 两种编辑方式都经过同一份草稿并发布流出,这样可以在一个代理在开始直播前审查一个构建者的变化,而一个代理可以拾取你留下的地方.
- 在前线,代理使用 MCP 服务器的页面和主题工具:
list_pages, (中文(简体) ),get_page, (中文(简体) ),create_page, (中文(简体) ),update_page, (中文(简体) ),publish_page, (中文(简体) ),discard_page_draft, (中文(简体) ),list_themes, (中文(简体) ),create_theme, (中文(简体) ),update_theme和匹配的删除工具. - 教一个编码代理写好 FrontLit 页面,安装 前置技能。 。 。 .
- 在自己的应用中,构建器的布局通过
onChange和你经纪人读和写的JSON一样 见docs/ai-editing.md用于计划中的建设者AI编辑设计.
丰富的文本编辑和渲染 @frontlit/text-editor,该软件包依赖并自动安装.
安装
npm i @frontlit/page-builder
# or
pnpm add @frontlit/page-builder
同伴依赖性 : react 财务报告和审定财务报表 react-dom (^18或^19) (中文(简体) ). 下一个J是 没有 所需经费。 尾风是 没有 需要 - 导入已编译的样式表 :
import "@frontlit/page-builder/styles.css";
文件包括公用设施、默认符号、取出主题的字体(Inter、Playfair和其余),以及来自TipTap的道具样式 @frontlit/text-editor。已经通过 next/font 继续工作 : --font-inter 在文档中仍然获胜.
未来: 将选择主题者的脸从 styles.css 进入选入 @frontlit/page-builder/fonts.css。已经装入 Inter、 Playfair 和 其余的主机(例如通过 next/font)可以跳过该文件;其他人在旁边导入该文件 styles.css。 。 。 . --font-* 和系统反弹 theme.css 保持原样.
如果主机已经运行了 Tailwind CSS v4, 您可以跳过 styles.css 并扫描包代替。 导入内容丰富且代码块
@import "@frontlit/page-builder/theme.css";
@import "@frontlit/text-editor/prose.css";
@source "./node_modules/@frontlit/page-builder";
@source "./node_modules/@frontlit/text-editor";
使用量
import {
PageRenderer,
PageBuilder,
createDefaultLayout,
getDefaultTheme,
} from "@frontlit/page-builder";
import "@frontlit/page-builder/styles.css";
// Read-only rendering (a published page, a marketing site, a preview):
<PageRenderer
layout={createDefaultLayout()}
theme={getDefaultTheme()}
pageData={{ pageType: "landing" }}
/>;
// The interactive editor — persist however you like:
<PageBuilder
onChange={({ layout, theme }) => {
/* save */
}}
/>;
两者 PageRenderer 财务报告和审定财务报表 PageBuilder 是客户部件(该包船带有 "use client" 关于UI条目的指示).
可选:客户端路由
内部 /... 链接变为本地 <a> 默认标记,所以包在Vite,Remix,Astro,或任何其他反应主机中工作. next.js(或任何其他路由器)可以注入自己的链接:
import Link from "next/link";
import {
PageRenderer,
type PageBuilderLinkProps,
} from "@frontlit/page-builder";
function AppLink(props: PageBuilderLinkProps) {
return <Link {...props} />;
}
<PageRenderer layout={layout} theme={theme} linkComponent={AppLink} />;
PageBuilder 接受相同的建议 linkComponent 道具并转发到直播预览.
服务器渲染( React Server 组件)
PageRenderer 是客户端组件。 要在服务器上渲染已公布的页面, 请使用 ServerPageRenderer 从 @frontlit/page-builder/server:静态块在服务器上渲染并发送无JavaScript;只有交互部分(移动菜单,marquee,电子邮件/支持表,复制按钮,链接)是客户端岛屿.
import { ServerPageRenderer } from "@frontlit/page-builder/server";
import { resolveTheme } from "@frontlit/page-builder/theme";
const theme = resolveTheme(themeId, themeStyle);
<ServerPageRenderer layout={layout} theme={theme} pageData={pageData} />;
因为没有任何东西作为函数跨越服务器/客户端边界,所以不需要回调. 相反:
- 链接 ——将页面包装在客户端组件中,使
PageBuilderLinkProvider(从)@frontlit/page-builder/islands/nav-link用你的路由器链接. - 轻/暗控制 ——通过即时客户要素作为
themeSwitcher(例如,以@frontlit/page-builder/islands/theme-mode-switcher);在页脚中显示. - 图像 - 打电话
setImageAttributesResolver在启动时交换图像src编号 :srcSet用于您优化器的 URL( 网站应用程序使用 Next )getImageProps) (中文(简体) ). - 黑暗模式 区域背景与
dark在祖先的类,所以服务器不需要颜色模式.
服务器构建与主捆绑分开( Nametsup.server.config.ts:其客户岛屿列于 tsup.islands.ts,用一个 "use client" ,并按服务器条目导入 。 需要状态或效果的块要么必须生活在该列表中,要么被拆分,这样只有它的互动部分才会这样做. 服务器渲染器所用的块搜索是 src/server/registry.ts; 保持与 src/registry.ts 当添加块时.
里面的东西
| 子路径 | 出口的东西 |
|---|---|
@frontlit/page-builder | 底下的东西,从一个地方再出口 |
@frontlit/page-builder/models | Theme, (中文(简体) ), WidgetInstance, (中文(简体) ), Widget<T>, (中文(简体) ), Page, (中文(简体) ), Media等(再出口) TextEditorContent 从 @frontlit/text-editor(中文(简体) ) |
@frontlit/page-builder/primitives | 主题 UI 原子 (Button, (中文(简体) ), Header1-4, (中文(简体) ), Section, (中文(简体) ), PageCard,.)+内置主题 |
@frontlit/page-builder/components | 共享演示文稿位 : Image, (中文(简体) ), NavLink, (中文(简体) ), VideoWithPreview (再出口) TextRenderer 从 @frontlit/text-editor(中文(简体) ) |
@frontlit/page-builder/blocks | 块库:头,英雄,内容,地物,Faq,定价,Banner,EmailForm,Foder, |
@frontlit/page-builder/renderer | PageRenderer - 做一个页面的 WidgetInstance[] 布局,带有 editing 用于构建器内部的模式 |
@frontlit/page-builder/builder | PageBuilder ——完整的WYSIWYG编辑器(添加/再移动/重排块,编辑设置,切换主题) |
@frontlit/page-builder/data-slots | 服务器安全帮助主机在渲染前解析命名的数据槽 |
@frontlit/page-builder/server | ServerPageRenderer, (中文(简体) ), setImageAttributesResolver ——服务器组件页面渲染(见上文) |
@frontlit/page-builder/theme | resolveTheme, (中文(简体) ), themes, (中文(简体) ), generateThemeStyles ——服务器可调用,对客户端组件来说足够轻 |
@frontlit/page-builder/primitives/server | 从服务器组件调取的无钩原始 |
@frontlit/page-builder/islands/* | 小岛屿nav-link, (中文(简体) ), theme-mode-switcher) 主机可以在没有完整客户端捆绑的情况下导入 |
createDefaultLayout() 编号 : getDefaultTheme() (从根口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口口.
header 财务报告和审定财务报表 footer 需要布局级块。 建造者通过添加来修复遗留物或空出初始布局,使其保持在外缘上,绝不允许移动或删除.
许可证
麻省理工学院