Manifest 中的清单成员
edge_side_panel 清单成员
发布于
edge_side_panel 是 Microsoft Edge 的清单成员,让用户把已安装的 PWA 固定到 Edge 侧边栏,也就是
浏览器窗口右侧那条竖向的应用栏。它唯一的属性 preferred_width 用来指定打开宽度,默认最小宽度为
376 像素。
只有桌面端的 Microsoft Edge(Windows、macOS、Linux)实现了这个成员。Chrome 155、Firefox 157 与 Safari 27 把它当作未知成员丢弃,不报错。Microsoft 自己的文档带有一条 2026 年 7 月的更新,说明 这个特性正在弃用,将不再受支持。新项目应避免使用。
| 属性 | 值 |
|---|---|
| 类型 | 对象。写入空对象 {} 即可启用;唯一支持的属性是 preferred_width,取值为以 CSS 像素为单位的数字。 |
| 默认值 | 缺省。没有该成员时 Edge 不提供把应用固定到侧边栏的入口;写 {} 时侧边栏以 376 px 的默认最小宽度打开应用,用户可以拉宽。 |
| 示例值 | { "preferred_width": 480 }。 |
Microsoft 的文档要求清单先具备 name、short_name、description 与 icons,该成员才会生效,
因为侧边栏商店的列表就是从这几项生成的。preferred_width 低于 376 px 时,Edge 按 376 px 处理;用户
仍可把面板拉大,或缩小到最小宽度为止。
固定在侧边栏里的应用默认收到桌面端的 User-Agent Client Hints,即使存在移动端变体也是如此。 侧边栏通过一个 UA-CH 品牌向页面表明身份,这是官方支持的检测途径;Microsoft 把匹配 User-Agent 字符串列为备选,并建议不要使用。
在清单中加入一行就能启用侧边栏。运行时再检测是否处于侧边栏中,据此选择布局。
让音乐播放器以 480 px 进入侧边栏
链接到“让音乐播放器以 480 px 进入侧边栏”一节一个双栏布局的播放器放不进 376 px,于是请求 480。用户固定该应用时,Edge 以这个宽度打开侧边栏; 清单的其余部分就是一份普通的可安装 PWA。
{ "name": "PWAmp music player", "short_name": "PWAmp", "description": "A skinnable music player app to play your favorite mp3 files", "start_url": "/", "display": "standalone", "icons": [{ "src": "/favicon-256.png", "sizes": "256x256", "type": "image/png" }], "edge_side_panel": { "preferred_width": 480 }}去掉 preferred_width 仍然保留固定入口,并把宽度交给用户决定;布局已经适应 376 px 时,可以这样设置。
检测侧边栏环境并回退
链接到“检测侧边栏环境并回退”一节Edge 通过 User-Agent Client Hints 品牌暴露侧边栏。没有 navigator.userAgentData 的浏览器
(Firefox 157、Safari 27)走回退分支,按普通窗口处理。
function isInEdgeSidebar() { if (!('userAgentData' in navigator)) return false; // 没有 UA-CH:不是 Edge 侧边栏 return navigator.userAgentData.brands.some((b) => b.brand === 'Edge Side Panel');}
document.documentElement.dataset.layout = isInEdgeSidebar() ? 'sidebar' : 'window';用这个 data 属性在 CSS 中调整布局。侧边栏的视口更窄、更高,一条 max-width 媒体查询
就能完成大部分调整,无需为此拆分应用逻辑。
在移动优先的站点上给侧边栏提供桌面布局
链接到“在移动优先的站点上给侧边栏提供桌面布局”一节因为侧边栏发送的是桌面端客户端提示,按 Sec-CH-UA-Mobile 请求头选择移动端包的站点会把桌面版
发给一个 376 px 的面板。在服务端先检查品牌再做选择。
// Express 中间件:在 Edge 侧边栏内优先使用紧凑布局。app.use((req, res, next) => { const brands = String(req.get('Sec-CH-UA') ?? ''); res.locals.compact = brands.includes('"Edge Side Panel"') || req.get('Sec-CH-UA-Mobile') === '?1'; next();});Sec-CH-UA 是每个请求都会发送的低熵提示,这项检查不需要 Accept-CH 选择加入。
另请参阅
链接到“另请参阅”一节- Microsoft Edge 上的 PWA(侧边栏、商店)
- edge_side_panel 浏览器支持
- icons 清单成员
- description 清单成员
- Build PWAs for the sidebar in Microsoft Edge(learn.microsoft.com)
- Microsoft Edge Explainers: Side Panel(github.com)
规范
| 规范 | 状态 |
|---|---|
| Microsoft Edge Explainers: Side Panel | 说明文档 |