用途:配置 Unlayer 的邮件、页面、弹窗与文档构建器,行为由 unlayer.init() 选项和运行时方法控制,覆盖功能、外观、动态内容、安全与文件存储。注意:从构建器内图片打开的图片编辑器属于本技能;独立图片编辑器与 @unlayer/react-image-editor 请用 unlayer-image-editor。
主要能力:功能开关(features,如 audit、preview、undoRedo、stockImages、userUploads、preheaderText、textEditor 子项,以及付费的 ai、collaboration、sendTestEmail);外观与主题(appearance.theme 支持 modern_light、modern_dark、classic_light、classic_dark,可配置面板停靠与操作栏位置,运行时用 setAppearance 或 setTheme);自定义字体(fonts.customFonts);标签页配置(tabs);合并标签(setMergeTags,支持嵌套与 repeat 规则,setMergeTagsConfig 可设自动补全触发字符);设计标签(setDesignTags,仅在编辑器 UI 替换、不进入导出);显示条件(setDisplayConditions,付费);特殊链接(setSpecialLinks);HMAC 安全(服务端用 Project Secret 生成签名,客户端传入 user.id 与 signature);文件存储与图片上传(registerCallback('image') 自定义上传,registerProvider('userUploads') 文件管理器,需 user.id);本地化(locale、textDirection、translations);校验(setValidator、setToolValidator、audit);safeHtml(基于 DOMPurify 的 XSS 防护)。
必要用法:密钥位置为 Project ID 与 Project Secret 在 Dashboard > Project > Settings > API Keys,Cloud API Key 用于图片/PDF 导出,控制台为 console.unlayer.com。HMAC 需服务端生成,Node.js 示例:crypto.createHmac('sha256','YOUR_PROJECT_SECRET').update(String(userId)).digest('hex');Python 用 hmac.new(b'YOUR_PROJECT_SECRET', bytes(str(request.user.id), encoding='utf-8'), digestmod=hashlib.sha256).hexdigest()。
限制与常见错误:safeHTML(大写)已弃用,应使用 safeHtml;features.blocks=false 只禁用区块不隐藏标签页,需用 tabs 配置;colorPicker.presets 已弃用,改用 colorPicker.colors;文件管理器必须设置 user.id;Project Secret 绝不能放在前端;合并标签语法需与模板引擎一致(Handlebars、Liquid、Jinja 等)。付费功能包括自定义 CSS/JS、显示条件、样式指南、导出图片/PDF/ZIP、AI 功能与协作。其余细节暂未提供。