别再手写大屏了!用这套「3D 地图 + 拖拽脚手架」示例源码,交付效率提升 80%

我基于已经发布到 npm 的两个包,几个小时就做了一个完整的示例项目 screen-demo,直接搭出 4 套不同行业方向的大屏。目标是:开箱即用、可配置、可二次开发。

两个核心依赖:

  • @lius1314/china-map-3d-designer v1.1.5 ------ 3D 中国地图设计器 SDK
  • @lius1314/visual-dashboard-scaffold v1.2.3 ------ 可视化大屏脚手架 SDK

下面逐个看看这 4 套大屏长什么样、用了哪些能力。


一、智慧文旅景区运营大屏

行业方向:文旅 / 景区 / 城市运营

这套大屏采用蓝紫科技风,顶部标题使用渐变字体,底部 Dock 导航可以在四个子页面之间切换:

  • 文旅总览:左右两侧分布实时客流趋势、热门景区排行、游客来源占比、服务响应趋势、服务能力雷达、景区指标 TOP 排行;中间是 3D 景区客流态势图。
  • 客流感知:左侧三块 3D 翻转卡片 + 右侧大幅 3D 地图,突出客流热点。
  • 趋势研判:左右对称布局,八块指标卡围绕中间地图,适合宏观趋势分析。
  • 服务运营:左侧服务分类菜单 + 顶部关键指标 + 中间服务运营台。

技术亮点:

  • 底部 Dock 使用 visual-dashboard-scaffold 的 footer 行为配置,点击切换页面。
  • 中间 3D 地图使用 china-map-3d-designer 的纯展示模式,接入景区客流数据。
  • 卡片背景、标题装饰、入场动画全部通过配置面板调整,没有硬编码 CSS。

二、智慧物流园区运营大屏

行业方向:物流 / 园区 / 供应链

绿色系主题,整体布局更紧凑,强调订单、仓储、运力、履约等核心业务指标:

  • 左侧:订单吞吐趋势、仓储周转排行、准时履约 KPI
  • 右侧:运力结构占比、活跃车辆趋势、干线业务 TOP 排行
  • 中间:干线运输态势图(3D 地图)

这套大屏把 visual-dashboard-scaffold 的像素布局优势发挥得比较充分:左右两侧卡片严格对齐设计稿位置,中间地图占据核心视觉区。整体没有底部导航,适合单页长时间展示。


三、工业物联网设备运维大屏

行业方向:工业 / 物联网 / 设备运维

青蓝色工业风,中间是全国设备监控态势图,左右三块指标卡对称排布:

  • 左侧:设备在线趋势、设备工单事件、产线热力排行
  • 右侧:服务能力雷达、设备类型占比、SLA 达成率

这套大屏重点展示了如何把设备状态、告警事件、SLA 等运维数据映射到 3D 地图上。地图上的柱图和散点由 china-map-3d-designer 的 MapDataInput 数据驱动,区域数值高低一眼可见。


四、绿色能源低碳运营大屏

行业方向:能源 / 双碳 / 电力

银白 + 浅蓝冷色调,科技感更强,也是页面最多的一套大屏:

  • 能源总览:左右负荷趋势、能源站点排行、资源结构占比、低碳能力雷达,中间能源低碳态势图。
  • 负荷监控:大幅 3D 地图 + 顶部能源核心指标 + 两侧排行和趋势。
  • 趋势研判:八块指标卡 + 中间态势地图 + 底部态势趋势。
  • 系统管理:左侧调度菜单 + 右侧能源节点资源表。
  • 运维工单:全屏工单台。
  • 广东省能源视角 :单独展示省级地图,演示 china-map-3d-designer 的 initialRegion 固定区域能力。

底部 Dock 同样支持多页面切换,并且包含一个独立的省级地图入口。


两个 npm 包分别解决什么问题

@lius1314/china-map-3d-designer

基于 Three.js 的 3D 中国地图可视化设计器 SDK,主要职责是地图本身:

  • 3D 省级 / 市级地图渲染,支持双击下钻;
  • 顶面、侧面、边界、粒子、柱图、飞线、散点、标签等 9 大图层可配;
  • 设计器模式所见即所得,导出 JSON 即可用于生产;
  • 支持固定显示某省(如广东省能源视角)。

如果你想深入了解 3D 地图设计器本身的设计理念、主题预设和配置工作流,可以看我之前写的这篇文章:

我用Threejs 搓了一个 3D 中国地图设计器,开箱即用

@lius1314/visual-dashboard-scaffold

可视化大屏脚手架,主要职责是"把地图和图表装配成完整大屏":

  • 编辑模式下拖拽、缩放、复制、删除区块;
  • 多页面路由与底部 Dock 导航;
  • 头部、中间、底部三层布局,全局与页面配置分离;
  • 区块注册机制,ECharts、3D 地图、业务表格都能接;
  • 主题、背景、卡片、字体、图标资源内置;
  • 配置导入导出、本地持久化、页面参数传递、事件通信。

如果你需要的是一套"能自己调布局、能导出配置、能交付给业务方"的大屏框架,可以看下这篇文章:

可视化大屏设计器脚手架:从设计到交付的一站式方案


为什么是"开箱即用"

screen-demo 这个项目已经把两件事情做完了:

  1. 静态资源同步 :visual-dashboard-scaffold 的主题图、china-map-3d-designer 的 GeoJSON 都已经通过 postinstall 脚本自动复制到 public/ 目录。
  2. 默认配置写好 :4 套大屏的 JSON 配置分别放在 src/config/default-dashboard-theme1.json ~ theme4.json,直接引入即可渲染。

你只需要:

bash 复制代码
npm install
npm run dev

就能看到 4 套大屏。替换数据、调整布局、增删页面,都可以在编辑模式下完成。


适合谁用

  • 需要快速出 Demo 的前端 / 可视化开发;
  • 做智慧文旅、智慧物流、工业互联网、能源双碳方向的项目;
  • 希望把"大屏框架"和"业务图表"拆开的团队;
  • 想基于成熟 npm 包做二次交付的开发者。

写在最后

screen-demo 不是从零写 4 个大屏,而是验证一种思路:把通用能力下沉到 npm 包,业务层只做配置和数据。这样同一个团队可以在不同项目里复用同一套大屏框架,而 3D 地图部分也可以独立迭代。

如果你对 3D 地图设计器感兴趣,推荐阅读我之前的付费文章;如果你更需要完整的大屏编排与交付能力,可以看这篇文章同步发表的文章呀。

相关资源:

  • npm:@lius1314/china-map-3d-designer v1.1.5
  • npm:@lius1314/visual-dashboard-scaffold v1.2.3
  • 示例项目:screen-demo

示例源码我已经放在公众号(柳杉前端)同名文章底部了,如果你需要的话可以去获取呀。

免责声明

本项目内置的图片资源(背景图、卡片素材、头部标题装饰、图标等)及字体文件(优设标题黑、阿里巴巴普惠体、DS-Digital、庞门正道标题体、思源黑体等)均来源于网络,仅供学习和参考使用,不得用于商业用途。如有侵犯您的版权,请联系作者进行删除。

相关推荐
lovingsoft3 分钟前
Chrome Lighthouse 详解
前端·chrome
Qlly14 分钟前
全栈工程师怎么接需求?从一句「加个功能」聊到能开发、能验收
前端·后端
马可家的菠萝17 分钟前
你的微信“文件传输助手”,是不是已经成了第二个网盘?
前端·后端·架构
略略略啦18 分钟前
Vibe Coding 基于Spec DD和TDD的实践指南
前端
shmily麻瓜小菜鸡39 分钟前
前端实现图片与PDF文字识别敏感信息打码方案
前端·pdf·状态模式
打工仔折腾 AI1 小时前
LangChain 工具调用实战:从 Tool 定义到 Agent 执行链路拆解
java·前端·人工智能·后端·python·langchain·ai agent 实战
汉堡大王95271 小时前
单次输出拉到100万Token:拆完 Gemini 4 Argon 的续写协议,才看懂谷歌这7个月在憋什么
前端·人工智能·后端
看浪的路人1 小时前
第9讲:大模型应用监控与可观测性——OpenTelemetry + Prometheus + Grafana 全链路追踪
java·前端·spring
内存过载1 小时前
用表格模拟甘特图:项目排期的土办法
前端·低代码
葡萄城技术团队1 小时前
用 SpreadJS 数据验证实现省市区三级联动
前端