添加应用快捷方式
发布于 更新于
manifest 的 shortcuts 成员声明快捷操作,让用户直接打开已安装应用中的页面。操作系统负责显示菜单:
Windows 用户右键点击应用的任务栏图标,Android 用户长按启动器图标,就能打开它。
你需要一个可安装的 PWA(见让它可安装),因为菜单只对已安装的应用显示; 再选两到四个用户常用的页面作为目的地。这是一项 Chromium 功能(Windows、macOS、ChromeOS 与 Android 上的 Chrome 与 Edge);版本见第 4 步的表格。
1. 在 manifest 中声明 shortcuts
链接到“1. 在 manifest 中声明 shortcuts”一节每一项都需要 name 与 url;short_name、description 与 icons 可选。按重要性排列数组。
manifest 规范建议浏览器按 manifest 顺序显示条目,并允许为适配宿主操作系统的限制而截断列表。
{ "name": "Ledger", "start_url": "/app/", "scope": "/app/", "display": "standalone", "icons": [{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" }], "shortcuts": [ { "name": "New invoice", "short_name": "New", "description": "Create a new invoice", "url": "/app/invoice/new?source=shortcut", "icons": [{ "src": "/icons/shortcut-new-192.png", "sizes": "192x192", "type": "image/png" }] }, { "name": "Dashboard", "url": "/app/dashboard?source=shortcut", "icons": [{ "src": "/icons/shortcut-dashboard-192.png", "sizes": "192x192", "type": "image/png" }] } ]}每个快捷方式用一张 192×192 的 PNG,或者用 48 dp 系列(36、48、72、96、144、192)获得逐像素精确的渲染;
Chromium 不支持 SVG 快捷方式图标,而 macOS 的 Dock 菜单根本不显示图标,所以只看名称也要能分清各项操作。
?source=shortcut 参数可以让分析工具统计从菜单发起的启动。
2. 让每个快捷方式的 URL 都保持在 scope 内
链接到“2. 让每个快捷方式的 URL 都保持在 scope 内”一节快捷方式的 url 必须位于 manifest 的 scope 之内;浏览器会丢弃超出 scope 的 URL。相对 URL 相对于
manifest 文件的位置解析,而不是相对于页面,所以位于 /app/manifest.webmanifest 的 manifest 里写
"url": "../projects" 会打开 /projects,这超出了 /app/,浏览器会忽略它。目的地不必能从应用内导航到达;
只要在 scope 内,就可以只提供快捷方式入口。
3. 在应用内镜像这份菜单
链接到“3. 在应用内镜像这份菜单”一节没有任何 JavaScript API 能报告当前浏览器与操作系统是否会绘制快捷方式菜单,W3C 规范把呈现方式与数量都 交给用户代理决定。把同样的操作也放进应用内菜单,让不支持快捷方式的浏览器用户也能访问。无条件显示这份菜单才是可靠的回退。 页面可以检查自己的 manifest,用它保持两份菜单同步。
async function shortcutsFromManifest() { const link = document.querySelector('link[rel="manifest"]'); if (!link) return []; try { const manifest = await fetch(link.href).then((response) => response.json()); return Array.isArray(manifest.shortcuts) ? manifest.shortcuts : []; } catch { return []; }}
shortcutsFromManifest().then((shortcuts) => { const menu = document.querySelector('#quick-actions'); menu.replaceChildren( ...shortcuts.map((shortcut) => { const link = document.createElement('a'); link.href = shortcut.url; link.textContent = shortcut.name; return link; }), );});4. 安装并打开快捷方式菜单
链接到“4. 安装并打开快捷方式菜单”一节安装应用,然后在 Windows 上右键点击任务栏图标,在 macOS 上右键点击 Dock 图标,在 Android 上长按启动器 图标。第 1 步的条目按顺序出现;选中其中一项会在该 URL 打开应用。Chrome DevTools 在 Application > Manifest(英文界面)下以 Shortcut #1、Shortcut #2 等形式显示解析后的条目,这是检查图标是否 能加载的最快方式。浏览器检查 manifest 更新时,已安装应用才会收到改动;Chrome 每天最多检查一次。
- 图例
- 支持
- 部分支持
- 需开启标志
- 不支持
- 未知
| 浏览器 / 平台 | 支持 | 版本 | 置信度 | 来源 | 备注 |
|---|---|---|---|---|---|
| Chrome (Android)# | 支持 | 85 | 低 | 来源 | — |
| Chrome (Desktop)# | 支持 | 96 | 低 | 来源 | — |
| Edge (Desktop)# | 支持 | 96 | 低 | 来源 | — |
| Samsung Internet# | 支持 | 14.0 | 低 | 来源 | — |
| Firefox (Desktop)# | 不支持 | — | 低 | 来源 | 1 |
| Safari (iOS)# | 不支持 | — | 低 | 来源 | 2 |
| Safari (macOS)# | 支持 | 17.4 | 低 | 来源 | — |
- 桌面版 Firefox 不支持 `shortcuts`。它的任务栏 web 应用(Windows,Firefox 143 起)由地址栏固定,而不是根据 manifest 安装。
- iOS 上不支持。
另请参阅
链接到“另请参阅”一节- Manifest 快捷方式(shortcuts)
- 安装后的应用快捷方式
- manifest: shortcuts 支持情况
- Get things done quickly with app shortcuts(web.dev)
- Web Application Manifest: shortcuts member(w3.org)
← 返回指南总览。