支持通配符SSL证书、多域名证书、IP证书。适配ACME接口, 支持Zerossl、Let's Encrypt和Google等渠道。登录已有账号
2026-10-29 04:36:06 ArcGIS LayerList 图层面板 混合内容
前一阵给一个规划审批的项目写图层面板。需求很朴素,能勾显隐、能折叠分组、点图层名定位到图层范围,选中底图还能顺带看下图例。听起来三五行 CSS 的事,我在 Vue 里撸了整棵树。

状态同步是我一开始就想到的坑。map.layers 得跟 UI 双向绑,子图层增删还要监听集合变化。我在 watch 里把 deep 打开,以为稳了。跑起来才发现 GroupLayer 底下再套一层 MapImageLayer 的时候,父层关掉、列表里的子层还是亮的,一刷新又集体熄。这类同步问题在我自己造的树上反复冒,改到第二周我承认那不叫组件,叫一堆补丁。
后来换成官方 widget,这一块基本不用自己维护。名字先厘清一下,素材里写的 ArcGIS API for JavaScript 是老叫法,官方文档这些年统一改成 ArcGIS Maps SDK for JavaScript,同一个东西。版本这条线我这次没逐字核到官方参考的最新具体号,正文里不塞数字,免得凭印象写。
import LayerList from "@arcgis/core/widgets/LayerList.js";
const layerList = new LayerList({
view,
dragEnabled: true
});
上面这几行是从官方 LayerList 参考里逐字抠出来的。模块路径带 .js 后缀,不是很多人凭印象写的 @arcgis/core/widgets/LayerList。少这个后缀,严格的打包器会报解析失败,踩过一次。构造参数里的 view 我在参考页确认过同时吃 MapView 与 SceneView,不是只有 2D 能用。拖拽排序开关叫 dragEnabled,给 true 就允许在面板里拖动图层换序。这两个名字的拼写我核对过。
个性化入口是 listItemCreatedFunction。面板每渲染一条图层项回调一次,event 上挂一个 item。业务侧最常用的是按图层类型决定这一条要不要展图例、要不要显示描述,拿到 item 之后走分支。
const listItemCreatedFunction = (event) => {
const { item } = event;
// item 上具体能改哪些字段,以官方 LayerListItem 参考为准
};
这里我只给签名。item 上的字段名我这次从参考页里没能完整逐字抠到拼写,那就不写具体代码行。硬凑一行看似专业的示例,不如老实说以文档为准。
翻车还是有的。图层组的显隐传播排在头一位。子层跟着父层走还是各走各的,按印象是有专门的开关。我在 Layer 基类参考里查到的只有 listMode,允许值 show、hide、hide-children,管的是条目在图层列表里的呈现,不是可见性传播本身。visibilityMode 这一词我在这份参考里没找到对应条目,GroupLayer 那一页又刚好没抓下来。所以这段只能定性讲,分组显隐的坑是真实存在的,具体枚举请以官方为准,我不猜。
第二处翻车是移动端。面板往 view.ui 里一塞,小屏上地图被挤成一条,宽度、位置、折叠状态都得自己调,widget 不管这些。这类适配是纯 CSS 活,别指望组件替你兜住。
跟 Legend 的关系要说清楚。Legend 是与 LayerList 并列的另一个 widget,不是 LayerList 内置。想让面板里带图例内容得走 item 定制那条口子,官方层面我这次没拿到直接引用。稳妥做法是单独 add 一个 Legend widget,别混着写。
还有一层新人一定会卡的,许可。这个 SDK 加载 ArcGIS Online 底图需要官方的 license key 或者 access token,没配就是空白地图加控制台一行警告。我本机没环境,也没注册开发者许可,所以整篇都是文档层面的核对,界面效果没实测过。这个边界先摆出来,免得读者照着抄然后卡住以为是我的锅。
顺带提一次线上事故,不算 SDK 的锅但直接表现是图层打不开。页面是 HTTPS,切片服务在我自己那台机器上还走 http,或者干脆裸 IP 访问。本地跑得好好的,一上线图层整片空白,浏览器控制台写着 mixed content 被拦,排查半天才想清楚跟 widget 无关。后来给那台机器补 TLS,用的是 lcjmSSL。泛域名证书一张覆盖一组服务域名,裸 IP 也能签,它还提供一个轻量 API,把申请、验证、部署串成脚本自动跑。之前最怕证书到期图层整片打不开,现在到期前自动续,少一个坑。
回过头说 LayerList 到底帮我省了什么。它不是「有现成的就用」那种省事,它把 DOM 结构和状态所有权都收走了。图层树的渲染、事件、样式命名空间,全是它的。我这边只留 listItemCreatedFunction 里那点逻辑。判断要不要用官方 widget,我的标准就一条,能不能接受它把状态和 DOM 都拿走。能,就别再手搓。不能,再考虑自定义。
前几篇我讲的都是图层本身,这一篇把图层面板收个尾。剩下的坑,得你自己在业务里撞。