Files
sankey/miniapp/README.md
2026-02-14 10:19:12 +08:00

29 lines
1.7 KiB
Markdown

# 小程序端(当前可用范围)
当前目录已从骨架升级为可用版,支持以下能力:
- 顶部 Logo / 主题 / 上传 / 导出区域
- 启动默认加载:优先读取 `data/sankey.xlsx`(位于小程序包内 `miniapp/data/sankey.xlsx`),若开发者工具环境限制读取则自动回退到内置同内容 JSON
- 文件上传与解析:`csv / xls / xlsx`
- 默认列映射:
- 源数据列优先匹配 `data/value/数据/值`
- 源描述列优先匹配 `source/源`
- 目标描述列优先匹配 `target/目标`
- 若无显式数值表头,则回退到第二行首个数字列
- 源/目标列选择交互与聚合统计
- 信息日志(解析信息 / 告警 / 错误)
- 原生 canvas 桑基图预览
- 导出能力:
- `PNG`:保存到系统相册
- `SVG`:生成 `.svg` 文件写入用户目录,优先尝试打开,失败时复制路径
注意事项:
- `xlsx` 解析依赖 npm 包,若在微信开发者工具中提示模块缺失,请先执行“工具 -> 构建 npm”。
- 为提高稳定性,仓库已内置 `miniapp/vendors/xlsx.full.min.js`,作为解析回退路径;即使 npm 构建异常,`xlsx` 上传通常也可解析。
- 本仓库采用手动 npm 构建映射:
- 依赖入口为 `miniapp/package.json`,依赖安装目录为 `miniapp/node_modules`
- 构建输出目录为 `miniapp/miniprogram_npm`
- 打开仓库根目录工程或直接打开 `miniapp/` 目录,都可执行“工具 -> 构建 npm”。
- 当默认文件或上传文件未加载成功时,“数据选择”仅显示空状态提示,不展示占位列名。
- SVG 文件导出后是否可直接预览,取决于当前系统与微信版本对 SVG 文档的支持。