地图容器必须设显式高度(如500px或70vh),否则因父元素无高导致塌陷白屏;需确保DOM就绪后再初始化地图;Leaflet与ECharts叠加需统一坐标系;离线场景宜用SVG地图方案。

地图容器必须有明确宽高,否则白屏或渲染失败
很多 HTML 仪表盘接入地图后一片空白,根本原因不是 API 没加载,而是 #map 容器的 CSS 高度为 0。浏览器渲染时发现父元素没高度,子元素(地图)就塌陷了。
常见错误写法:<div id="map"></div> 配合 height: auto 或完全没设 height;正确做法是给 #map 显式声明 height,且不能依赖内容撑开:
- 固定像素:如
height: 500px - 视口单位:如
height: 70vh(推荐用于响应式大屏) - 避免用
min-height单独撑高,地图初始化时只读取初始offsetHeight
额外注意:<meta name="viewport"> 必须存在,否则移动端地图缩放、手势会异常甚至不响应。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
百度地图 JSAPI 初始化前要等 DOM 就绪
直接在 <script></script> 标签里调用 BMapGL.Map 构造函数,容易报 Cannot read property 'offsetWidth' of null —— 因为 document.getElementById('map') 还没挂载。
立即学习“前端免费学习笔记(深入)”;
安全做法只有两种:
- 把脚本放在


















