大网数据广告活动
Web 标准与前端开发

UserActivation

· 52CE 我爱测

`UserActivation`** 接口提供有关用户当前是否正在与页面交互,或者自页面加载以来是否已完成交互的信息。

HTML DOM

UserActivation 接口提供有关用户当前是否正在与页面交互,或者自页面加载以来是否已完成交互的信息。

此 API 仅在 window 上下文中可用,web worker 中不可用。

实例属性

  • UserActivation.hasBeenActive
    • : 指示当前窗口是否具有粘性(用户)激活。
  • UserActivation.isActive
    • : 指示当前窗口是否具有瞬态(用户)激活。

描述

此类型的对象可通过 navigator.userActivation 属性访问,并可用于查询有关 window 的用户激活状态的信息。

用户激活意味着用户当前正在与页面交互,或者自页面加载以来已完成交互。用户激活可以通过按钮点击、指针触摸或其它的用户界面的交互来触发。

window 用户激活状态有两种:

  • Transient activation(用户当前正在与页面交互)和
  • Sticky activation(自页面加载以来,用户至少交互过一次)。

有关更多信息以及需要粘性或瞬态激活的 API 列表,请参见由用户激活控制的特性 。

示例

检查最近是否执行过用户手势

使用 navigator.userActivation 访问 UserActivation 对象,然后使用 UserActivation.isActive 检查用户当前是否正在与页面进行交互(Transient activation)。

if (navigator.userActivation.isActive) {
  // 例如,继续请求播放媒体
}

检查是否执行过用户手势

使用 UserActivation.hasBeenActive 检查用户是否曾与页面进行过交互(Sticky activation)。

if (navigator.userActivation.hasBeenActive) {
  // 例如,继续自动播放动画。
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。