SuperAPI AI 工具集

unlayer-elements

通用与其它

查看项目

更新于 10-16 02:28

技能介绍

用途:@unlayer/react-elements 是一组 React 组件,无需可视化编辑器,直接用 JSX 构建邮件、页面与文档。同一份 JSX 可渲染为三种输出:邮件模式(<Email>)生成基于表格、兼容 Outlook/Gmail/Yahoo 的 HTML;Web 模式(<Page>)生成响应式 div/flexbox HTML;文档模式(<Document>)生成适合打印/PDF 的 HTML。输出与 Unlayer 编辑器产物一致,可用 renderToJson() 得到设计 JSON,再由编辑器 loadDesign() 打开,让非开发者在可视化界面中编辑代码模板。支持 SSR(Next.js、Remix、renderToString)。

主要能力:renderToHtml() 返回最终 HTML 字符串;renderToJson() 返回 Unlayer 设计 JSON。组件包括根包装 Email/Page/Document、布局容器 Row/Column、内容项 Heading、Paragraph、Button、Image、Divider、Social、Menu、Table、Video、Html。

用法与结构:结构严格——Row 只能直接包含 Column,且列数必须与 layout(如 ColumnLayouts.TwoEqual)匹配;内容项只能放在 Column 内,不能嵌套。渲染时需直接传入根元素,若封装自组件需调用(如 renderToJson(MyEmail()))而非传 <MyEmail />。字体 fontFamily 用 { label, value } 对象;fontSize、padding、lineHeight、letterSpacing 用带单位字符串。大号数字或金额应使用 Heading。内联格式需用 <Paragraph html="…"> 并写真实标签。previewText 设置收件箱预览文字。Image 的 src 可为 URL 或 { url, width?, height? },其中宽高为原始尺寸;默认响应式,固定显示尺寸需设 autoWidth:false + maxWidth。

安装:npm view @unlayer/react-elements version 先确认版本,然后 npm install @unlayer/react-elements。该技能面向 0.1.11+。

适用场景:在代码中生成或组装模板(AI 生成、程序化邮件、设计系统);代码构建后由团队可视化编辑;SSR 场景。

限制:不适用于在应用中嵌入拖拽式可视化编辑器(见 unlayer-integration),也不用于从已保存设计或 Cloud API 导出 HTML/PDF(见 unlayer-export)。资料未提供收费、价格、平台与效果说明。