SuperAPI AI 工具集

unlayer-custom-tools

设计与创作

查看项目

更新于 10-16 01:06

技能介绍

这是 Unlayer 编辑器自定义拖拽工具的构建指南。每个工具需包含三部分:渲染器(renderer,编辑器内所见)、导出器(exporters,输出 HTML,邮件须用 table 结构)和属性编辑器(property editors,设置面板)。使用 unlayer.registerTool 注册,需提供 name、label、icon、supportedDisplayModes 等;选项按 content、colors 等分组,每个字段声明 widget 类型,如 text、image、color_picker、link、dropdown、border 等,取值方式各异(如 image 取 values.myField.url,link 取 values.myField.values.href,counter 返回字符串)。渲染用 unlayer.createViewer,导出分 web 与 email:邮件必须用基于 table 的 HTML,按钮、双栏等有安全模板;避免 flexbox、grid、position、float、box-shadow、calc() 等不安全属性。自定义属性编辑器通过 unlayer.registerPropertyEditor 注册 React 组件,组件需调用 updateValue。校验器 validator 返回错误数组,每项含 id、icon、severity、title、description,可与 defaultErrors 合并。初始化时工具以 custom# 前缀注册,如 custom#product_card,并通过 properties 覆盖默认值或传入 dropdown 选项。head.css/js 可注入样式脚本,CSS 需用 #${values._meta.htmlID} 作用域限定。常见错误包括缺少 custom# 前缀、邮件导出用 div、硬编码值等。具体收费、平台与完整 API 细节暂未提供。