自定义依赖加载
设计器内部依赖了多个第三方库,如 ECharts、XLSX、HTML2Canvas 等。当这些依赖需要从不同的 CDN 源加载或使用本地文件时,可以通过 loadjs.depend 方法来自定义依赖的加载路径。
重要提示
使用 loadjs.depend 可以完全替换内置的依赖加载链接,支持自定义 CDN 源、本地文件路径或私有仓库地址。
内置依赖列表
FormCreate 设计器默认包含以下依赖:
javascript
// 内置依赖配置
{
xlsx: 'https://unpkg.com/xlsx@0.18.5/dist/xlsx.full.min.js',
echarts: 'https://unpkg.com/echarts@5.6.0/dist/echarts.min.js',
mpegts: 'https://unpkg.com/mpegts.js@1.8.0/dist/mpegts.js',
html2canvas: 'https://unpkg.com/html2canvas@1.4.1/dist/html2canvas.min.js',
jspdf: 'https://unpkg.com/jspdf@3.0.1/dist/jspdf.umd.js'
}版本固定建议
为了确保最佳兼容性,建议在自定义依赖源时使用以下固定版本:
- XLSX:
0.18.5 - ECharts:
5.6.0 - MPEGTS.js:
1.8.0 - HTML2Canvas:
1.4.1 - jsPDF:
3.0.1
替换单个依赖
javascript
import { loadjs } from 'path/to/fcDesignerPro';
// 替换 ECharts 依赖为自定义 CDN
loadjs.depend('echarts', 'https://cdn.jsdelivr.net/npm/echarts@5.6.0/dist/echarts.min.js');
// 使用本地文件
loadjs.depend('xlsx', '/static/libs/xlsx.full.min.js');
// 使用私有 CDN
loadjs.depend('html2canvas', 'https://your-cdn.com/html2canvas@1.4.1/dist/html2canvas.min.js');批量替换依赖
javascript
import { loadjs } from 'path/to/fcDesignerPro';
// 批量替换多个依赖
loadjs.depend({
echarts: 'https://cdn.jsdelivr.net/npm/echarts@5.6.0/dist/echarts.min.js',
xlsx: '/static/libs/xlsx.full.min.js',
html2canvas: 'https://your-cdn.com/html2canvas@1.4.1/dist/html2canvas.min.js',
jspdf: '/static/libs/jspdf.umd.js'
});手动挂载依赖
当第三方库已经通过其他方式加载到 window 对象时,可以使用 loadjs.done 方法手动标记依赖为已加载状态:
javascript
import { loadjs } from 'path/to/fcDesignerPro';
import XLSX from 'xlsx';
// 检查并手动标记已加载的依赖
window.XLSX = XLSX
loadjs.done('xlsx');
if (window.echarts) {
loadjs.done('echarts');
}通过这些配置,您可以完全控制 FormCreate 设计器的依赖加载行为,适应不同的部署环境和网络条件。


