筛选、显隐与图层管理

使用过滤器、显隐和图层顺序构建可维护的业务图层列表,并统一管理地图状态。

🎯 引言

学完本文,你能实现四种常见地图操作:只显示符合条件的对象、关闭整个图层、调整图层覆盖顺序,以及把地图定位到某个图层的数据范围。

它们解决的问题不同:

用户想做什么地图执行什么操作方法
只看在线位置在一个 Layer 内筛选 FeaturesetFilter()
暂时关闭全部位置隐藏整个 LayersetLayoutProperty()
让点显示在面上方调整 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 中的数据。下面左侧显示全部四个点,右侧使用相同数据,只显示两个绿色在线点。

未筛选:2 个在线,2 个离线
筛选后:只显示 2 个在线点

🧩 同时使用多个筛选条件

作用:把界面中的多个选项组合起来,例如“在线,并且分数不低于 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,否则空条件也可能让结果难以理解。

下面分别修改“状态”和“最低分数”,观察两个条件如何共同决定最终显示的点数。

显示 4 个点

👁 控制整个图层和显示顺序

作用:把整个 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:为什么点击定位后仍然看不全数据?

通常是只计算了当前屏幕内的对象。应使用该图层完整业务数据中的坐标计算边界。


🧪 小练习

  1. 组合“在线”和“分数不低于 80”两个条件。
  2. 给点图层添加显示开关,并保存当前开关状态。
// 请在这里编写代码

🎉 恭喜你已经掌握筛选、显隐与图层管理啦!