跳转到内容

添加应用快捷方式

发布于 更新于

manifest 的 shortcuts 成员声明快捷操作,让用户直接打开已安装应用中的页面。操作系统负责显示菜单: Windows 用户右键点击应用的任务栏图标,Android 用户长按启动器图标,就能打开它。

你需要一个可安装的 PWA(见让它可安装),因为菜单只对已安装的应用显示; 再选两到四个用户常用的页面作为目的地。这是一项 Chromium 功能(Windows、macOS、ChromeOS 与 Android 上的 Chrome 与 Edge);版本见第 4 步的表格。

每一项都需要 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 内,就可以只提供快捷方式入口。

没有任何 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;
}),
);
});

安装应用,然后在 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低来源—
  1. 桌面版 Firefox 不支持 `shortcuts`。它的任务栏 web 应用(Windows,Firefox 143 起)由地址栏固定,而不是根据 manifest 安装。
  2. iOS 上不支持。

源数据: /compatibility/manifest-shortcuts.json · 全球使用占比: 84 % (StatCounter 2026-09, CC BY-SA 4.0)

来源: 规范 · MDN · 最近核验 2026-07-11 · 置信度: 低 (由来源计算)

← 返回指南总览。