Collision Filter
Runnable deck.gl example: Collision Filter. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.
single HTML file · CDN dependencies onlyinterface may contain Chinese labels
Source
<!--
示例:碰撞避让
核心逻辑:CollisionFilterExtension 按优先级保留标签,重叠的低优先级标签自动隐藏
数据:页面内生成的 80 个城市点位与名称,密度刻意做得不均匀
依赖:deck.gl 9.0 · jsDelivr CDN
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>碰撞避让</title>
<style>
html,body{height:100%;margin:0;background:#0d1117}
body{display:flex;flex-direction:column;overflow:hidden;
font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif;color:#e6e8ec}
.bar{position:relative;z-index:5;flex:0 0 auto;padding:8px 12px;background:#161b22;border-bottom:1px solid #252c36;
display:flex;gap:14px;align-items:center;font-size:12px;color:#8b93a1;flex-wrap:wrap}
.bar b{color:#58a6ff;font-weight:600}
.bar label{display:flex;gap:5px;align-items:center;cursor:pointer}
.bar input[type=range]{width:120px}
#cv{flex:1 1 auto;min-height:0;width:100%}
</style>
</head>
<body>
<div class="bar">
<span>标签 <b id="n">—</b></span>
<label><input id="c" type="checkbox" checked> 开启避让</label>
<label>字号 <input id="s" type="range" min="10" max="20" step="1" value="14"> <b id="sv">14</b></label>
<span>密度高处只剩优先级高的标签</span>
</div>
<canvas id="cv"></canvas>
<script src="https://cdn.jsdelivr.net/npm/deck.gl@9.0.35/dist.min.js"></script>
<script>
(function () {
'use strict';
if (typeof deck === 'undefined') {
document.body.innerHTML =
'<div style="padding:24px;color:#ff8c74">deck.gl 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
return;
}
var seeds = [
[116.39, 39.90], [121.47, 31.23], [113.26, 23.12], [104.06, 30.57],
[114.30, 30.59], [108.94, 34.34], [120.15, 30.28], [106.55, 29.56]
];
var names = ['北', '东', '南', '西', '中', '港', '新', '渝'];
var data = [];
for (var i = 0; i < 80; i++) {
var s = seeds[i % seeds.length];
data.push({
lng: s[0] + (Math.random() + Math.random() - 1) * 1.1,
lat: s[1] + (Math.random() + Math.random() - 1) * 0.9,
name: names[i % names.length] + '站 ' + (i + 1),
/* 优先级越大越不容易被挤掉 */
pri: Math.round(Math.random() * 100)
});
}
document.getElementById('n').textContent = data.length;
var labels = new deck.TextLayer({
id: 'labels',
data: data,
getPosition: function (d) { return [d.lng, d.lat]; },
getText: function (d) { return d.name; },
getSize: 14,
getColor: [232, 240, 255],
/* 深色描边,密集区域也读得出来 */
outlineWidth: 2,
outlineColor: [13, 17, 23, 255],
fontFamily: 'sans-serif',
extensions: [new deck.CollisionFilterExtension()],
collisionEnabled: true,
collisionGroup: 'city',
getCollisionPriority: function (d) { return d.pri / 100; },
pickable: true
});
var dots = new deck.ScatterplotLayer({
id: 'dots',
data: data,
getPosition: function (d) { return [d.lng, d.lat]; },
getRadius: 2.5,
radiusUnits: 'pixels',
getFillColor: [88, 166, 255, 220]
});
var deckgl = new deck.Deck({
canvas: document.getElementById('cv'),
width: '100%',
height: '100%',
initialViewState: {
longitude: 111,
latitude: 33,
zoom: 3.6,
pitch: 0,
bearing: 0
},
controller: true,
layers: [dots, labels],
getTooltip: function (info) {
return info.object ? info.object.name + ' · 优先级 ' + info.object.pri : null;
}
});
document.getElementById('c').addEventListener('change', function () {
labels.setProps({ collisionEnabled: this.checked });
});
document.getElementById('s').addEventListener('input', function () {
var v = parseInt(this.value, 10);
document.getElementById('sv').textContent = v;
labels.setProps({ getSize: v });
});
window.__deck = deckgl;
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.