Skip to content

自定义依赖加载

设计器内部依赖了多个第三方库,如 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 设计器的依赖加载行为,适应不同的部署环境和网络条件。