经纬志
首页 / OpenLayers / 使用示例

标注避让

点位密集时标注会互相压字,declutter: true 让渲染器自动丢弃重叠的文字,只保留可读的部分。

OpenLayers 10.3.1 · 更新 2026-10-28
源码与运行效果
运行效果

说明

ol.style.Style 构造时设置 declutter: true,同一图层内的文字与图标会参与碰撞检测。 复选框通过重新调用 setStyle() 生成两套样式:一套挂文字,一套只留圆点, 借此对比避让开启与关闭的显示密度。

操作结果
勾选「标注避让」重叠文字被隐藏,只显示不冲突的标注
取消勾选全部标注强制显示,出现层叠压字
放大地图间距拉开后更多标注重新出现

避让按渲染帧计算,要素上千时开销明显;静态数据可直接关闭,或在低缩放级别隐藏文字。