筛选、显隐与图层管理
🎯 引言
学完本文,你能实现四种常见地图操作:只显示符合条件的对象、关闭整个图层、调整图层覆盖顺序,以及把地图定位到某个图层的数据范围。
它们解决的问题不同:
| 用户想做什么 | 地图执行什么操作 | 方法 |
|---|---|---|
| 只看在线位置 | 在一个 Layer 内筛选 Feature | setFilter() |
| 暂时关闭全部位置 | 隐藏整个 Layer | setLayoutProperty() |
| 让点显示在面上方 | 调整 Layer 顺序 | moveLayer() |
| 查看某个图层的全部数据 | 调整地图视角 | fitBounds() |
🧱 只显示符合条件的对象
作用:保留一个图层中的部分对象,不需要删除或重新请求数据。
假设 places Layer 中有在线点和离线点。用户选择“只看在线”时,根据每个 Feature 的 properties.status 设置过滤条件:
map.setFilter('places', [
'==',
['get', 'status'],
'online',
])
这段表达式会逐个检查 Feature:get 读取 status,== 判断它是否为 online。符合条件的点继续显示,其他点暂时不绘制。
清空筛选时传入 null,所有点会重新显示:
map.setFilter('places', null)
筛选只改变 Layer 画哪些对象,不会删除 Source 中的数据。下面左侧显示全部四个点,右侧使用相同数据,只显示两个绿色在线点。
🧩 同时使用多个筛选条件
作用:把界面中的多个选项组合起来,例如“在线,并且分数不低于 80”。
先把用户已经选择的条件放进数组,再使用 all 要求一个 Feature 同时满足全部条件:
const conditions = []
if (filters.status !== 'all') {
conditions.push(['==', ['get', 'status'], filters.status])
}
if (filters.minScore !== null) {
conditions.push(['>=', ['get', 'score'], filters.minScore])
}
map.setFilter(
'places',
conditions.length > 0 ? ['all', ...conditions] : null,
)
all 表示所有条件都要满足;any 表示满足其中任意条件即可。没有选择任何条件时传 null,否则空条件也可能让结果难以理解。
下面分别修改“状态”和“最低分数”,观察两个条件如何共同决定最终显示的点数。
👁 控制整个图层和显示顺序
作用:把整个 Layer 显示或隐藏、修改它的外观,并决定多个 Layer 谁盖在谁上面。
显示与隐藏整个 Layer
筛选处理“一个 Layer 里显示哪些 Feature”,显隐处理“整个 Layer 要不要显示”。关闭“位置”开关时,可以直接修改 visibility:
map.setLayoutProperty('places', 'visibility', 'none')
map.setLayoutProperty('places', 'visibility', 'visible')
隐藏后,Source 数据和筛选条件仍然保留。再次显示时,不需要重新请求数据。
修改当前 Layer 的样式
颜色、透明度和线宽可以在 Layer 已经创建后继续修改:
map.setPaintProperty('places', 'circle-color', '#7c3aed')
map.setPaintProperty('places', 'circle-opacity', 0.6)
map.setPaintProperty('roads', 'line-width', 4)
这些方法只改变画面效果,不会修改 Feature 的业务字段。
调整覆盖顺序
多个 Layer 位于同一位置时,后绘制的 Layer 会盖住先绘制的 Layer。要把点移动到所有 Layer 的顶部,可以这样写:
map.moveLayer('places')
传入第二个 Layer ID,则把 places 移到该 Layer 之前:
map.moveLayer('places', 'areas')
下面的组件把三个效果放在一起。依次尝试隐藏点图层、修改点样式,再把点移动到紫色面图层下方,观察每个操作改变了什么。
图层面板通常用一份数组保存名称、稳定的 Layer ID 和开关状态:
const mapState = {
visibility: {
areas: true,
roads: true,
places: true,
},
order: ['areas', 'roads', 'places'],
}
界面按钮修改这份状态,再调用对应的 Mapbox 方法。刷新数据或重新加载 Style 后,也可以根据它恢复显隐和顺序。
📐 让地图自动显示某个图层的全部数据
作用:用户点击“定位”后,无论数据当前是否在屏幕内,都把地图移动到可以看全它们的位置。
先用该图层所有坐标计算边界,再把边界交给 fitBounds():
function focusCoordinates(coordinates: [number, number][]) {
const bounds = new mapboxgl.LngLatBounds()
coordinates.forEach(coordinate => bounds.extend(coordinate))
if (!bounds.isEmpty()) {
map.fitBounds(bounds, {
padding: 48,
maxZoom: 15,
})
}
}
bounds 表示能包住全部坐标的矩形范围。padding 在数据与地图边缘之间留出空间,maxZoom 避免只有少量相近数据时放得过大。
下面的地图一开始故意没有对准数据。点击“定位全部点”,地图会移动并缩放到能同时看到三个点的位置;点击“移开视角”可以再次对比。
范围应从该图层的原始 Geometry 计算。queryRenderedFeatures() 只返回当前屏幕中已经画出来的对象,不能用于计算屏幕外数据的完整范围。
🧾 小节总结
setFilter()决定一个 Layer 中显示哪些 Feature。- 多个条件使用
all或any组合,没有条件时传入null。 visibility显示或隐藏整个 Layer,不会删除 Source 数据。setPaintProperty()修改颜色、透明度和线宽。moveLayer()调整多个 Layer 的覆盖顺序。fitBounds()根据完整数据范围调整地图视角。
❓ 知识问答
Q1:筛选和隐藏有什么区别?
筛选只隐藏不符合条件的 Feature,显隐会一次关闭整个 Layer。
Q2:隐藏图层后还要重新请求数据吗?
不需要。Source 和筛选条件仍然存在,重新设为 visible 即可恢复。
Q3:为什么点击定位后仍然看不全数据?
通常是只计算了当前屏幕内的对象。应使用该图层完整业务数据中的坐标计算边界。
🧪 小练习
- 组合“在线”和“分数不低于 80”两个条件。
- 给点图层添加显示开关,并保存当前开关状态。
// 请在这里编写代码
🎉 恭喜你已经掌握筛选、显隐与图层管理啦!
