别再手写大屏了!用这套「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-scaffoldfooter 行为配置,点击切换页面。
  • 中间 3D 地图使用 china-map-3d-designer 的纯展示模式,接入景区客流数据。
  • 卡片背景、标题装饰、入场动画全部通过配置面板调整,没有硬编码 CSS。

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

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

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

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

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


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

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

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

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

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


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

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

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

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

底部 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、庞门正道标题体、思源黑体等)均来源于网络,仅供学习和参考使用,不得用于商业用途。如有侵犯您的版权,请联系作者进行删除。

相关推荐
乌夷1 小时前
Vue.js 3 的设计思路
前端·javascript·vue.js
丨我是张先生丨2 小时前
英语单词 Web Page
前端·css·css3
随风一样自由2 小时前
【前端+Vitest测试框架】Vitest | Playwright | WebdriverIO | Preview
前端·前端框架·可用性测试
前端之虎陈随易11 小时前
编程语言级别的Skill市场,AI Agent 的未来形态
前端·vue.js·人工智能·typescript·node.js
一路向北he11 小时前
字节钢铁军团--“提供情境,而非控制”
java·开发语言·前端
kyriewen11 小时前
豆包和千问同时关了智能体,我用它们搭的 3 个自动化全废了——迁移方案整理
前端·javascript·ai编程
前端一小卒11 小时前
我用 TypeScript 从零手写了一个 Claude Code,然后发现它的核心只有 30 行
前端·agent
大圣编程13 小时前
Python中continue语句的用法是什么?
开发语言·前端·python
yuhaiqiang13 小时前
随手 vibecoding 的浏览器插件已经 6000 多次下载,聊聊他的产品设计
前端·后端·面试