Web App Manifest 怎么配置 shortcuts 实现桌面长按快捷菜单

风芳君_1400

风芳君_1400

2026-10-22

1019人浏览

原创

shortcuts字段用于PWA配置桌面长按图标弹出的快捷菜单,必须为数组,每项含必填name和url,路径需同源且匹配start_url与scope,图标需多尺寸、src可访问。

web app manifest 怎么配置 shortcuts 实现桌面长按快捷菜单

Web App Manifest 中的 shortcuts 字段,是用来为 PWA(渐进式 Web 应用)配置桌面长按图标后弹出的快捷菜单项的。它只在支持该特性的浏览器和系统中生效(如 Chrome、Edge 在 Android 和 Windows 上,部分桌面版也支持右键菜单)。配置本身不复杂,但需注意格式细节和运行环境限制。

shortcuts 基本结构与字段说明

在 manifest.webmanifest 文件的根对象中添加 shortcuts 数组,每个对象代表一个快捷入口:

  • name:必填,用户可见的主名称,显示在菜单中(空间充足时优先使用)
  • url:必填,点击后跳转的相对路径(相对于 manifest 所在域名),如 "/orders" 或 "/search?q=new"
  • short_name:可选,当空间受限(如小屏或图标下方标签)时的备用名称
  • description:可选,辅助技术可读的描述,提升无障碍体验
  • icons:可选,为该快捷方式单独指定图标(非必须,会回退到 manifest 根级 icons);每个 icon 对象需含 src、sizes(格式为 "192x192",不能有空格)、type

一个可用的 shortcuts 配置示例

以下代码可直接放入你的 manifest.webmanifest 中:

"shortcuts": [
  {
    "name": "我的订单",
    "short_name": "订单",
    "description": "查看和管理所有订单",
    "url": "/orders",
    "icons": [
      {
        "src": "/icons/shortcut-orders-192.png",
        "sizes": "192x192",
        "type": "image/png"
      },
      {
        "src": "/icons/shortcut-orders-512.png",
        "sizes": "512x512",
        "type": "image/png"
      }
    ]
  },
  {
    "name": "立即搜索",
    "url": "/search",
    "icons": [
      {
        "src": "/icons/shortcut-search-192.png",
        "sizes": "192x192",
        "type": "image/png"
      }
    ]
  }
]

注意:sizes 字符串里不能出现空格(如 "192 x 192" 会导致整个 shortcut 失效);url 必须是同源路径,不可跨域。

AgentGen — HTML to PDF & Image
AgentGen — HTML to PDF & Image

将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……

下载

生效前提与常见问题

这个功能不是写完就立刻可见的,需满足几个条件:

  • 网站已通过 正确引入 manifest
  • 应用已以 PWA 形式被“添加到主屏幕”或“安装”(仅书签或地址栏打开无效)
  • 浏览器支持:Chrome 89+、Edge 91+、Samsung Internet 17+ 等;Android 和 Windows 平台较稳定,macOS Safari 目前不支持
  • manifest 文件响应头需包含 Content-Type: application/manifest+json(多数静态服务器默认支持)
  • 修改 shortcuts 后,需用户重新“添加到主屏幕”或等待浏览器自动更新(通常需刷新页面并重启 PWA)

与 Android App Shortcuts 的区别

别混淆 Web 的 shortcuts 和原生 Android 的 App Shortcuts:

  • Web 版是纯声明式 JSON,由浏览器解析,不涉及 Intent 或 Activity
  • 没有 shortcutId、enabled 或动态更新 API(如 ShortcutManager),无法运行时增删改
  • 图标复用 manifest 根级 icons,不支持 XML drawable 或资源引用
  • 不支持分类(categories)、禁用提示(shortcutDisabledMessage)等 Android 特有属性

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6743

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7550

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7518

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1063

5

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5630

6

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 244人学习