UserActivation

Baseline 2023
新推出

自 ⁨2023 年 11 月⁩ 起,此功能可在最新的裝置和瀏覽器版本中執行。此功能可能不適用於較舊的裝置或瀏覽器。

UserActivation 介面提供有關使用者當前是否與頁面互動,或自頁面載入以來是否已完成互動的資訊。

此 API 僅在 window 上下文中可用,不會暴露給 worker。

例項屬性

UserActivation.hasBeenActive 只讀

指示當前視窗是否具有粘滯使用者啟用。

UserActivation.isActive 只讀

指示當前視窗是否具有瞬時使用者啟用。

描述

可以透過 navigator.userActivation 屬性訪問此型別的物件,並可用於查詢視窗的使用者啟用狀態資訊。

使用者啟用表示使用者當前正在與頁面互動,或者自頁面載入以來已完成一次互動。使用者啟用可以由按鈕點選、指標觸控或使用者與頁面的其他互動觸發。

有兩種型別的視窗使用者啟用狀態:

  • 瞬時啟用(使用者當前正在與頁面互動)和
  • 粘滯啟用(使用者自頁面載入以來至少互動過一次)。

有關更多資訊以及需要粘滯或瞬時使用者啟用的 API 列表,請參閱 由使用者啟用限制的功能

示例

檢查是否近期執行了使用者手勢

使用 navigator.userActivation 訪問 UserActivation 物件,然後使用 UserActivation.isActive 檢查使用者是否正在與頁面互動(瞬時啟用)。

js
if (navigator.userActivation.isActive) {
  // proceed to request playing media, for example
}

檢查是否執行過使用者手勢

使用 UserActivation.hasBeenActive 檢查使用者是否曾與頁面互動(粘滯啟用)。

js
if (navigator.userActivation.hasBeenActive) {
  // proceed with auto-playing an animation, for example
}

規範

規範
HTML
# the-useractivation-interface

瀏覽器相容性

另見