tabs.onZoomChange
当标签页缩放时触发。
语法
js
browser.tabs.onZoomChange.addListener(listener)
browser.tabs.onZoomChange.removeListener(listener)
browser.tabs.onZoomChange.hasListener(listener)
事件有三个函数:
addListener(listener)
-
向此事件添加一个监听器。
removeListener(listener)
-
停止监听此事件。
listener
参数是要移除的监听器。 hasListener(listener)
-
检查
listener
是否已注册此事件。如果正在监听,则返回true
,否则返回false
。
addListener 语法
参数
listener
-
此事件发生时调用的函数。该函数接收以下参数:
ZoomChangeInfo
-
object
。关于缩放事件的信息。详见 ZoomChangeInfo 部分。
附加对象
ZoomChangeInfo
tabId
-
integer
。被缩放的标签页的 ID。 oldZoomFactor
-
number
。之前的缩放因子。 newZoomFactor
-
number
。新的缩放因子。 zoomSettings
-
tabs.ZoomSettings
。标签页的缩放设置。
示例
监听缩放事件并记录信息:
js
function handleZoomed(zoomChangeInfo) {
console.log(`标签:${zoomChangeInfo.tabId} 被缩放`);
console.log(`旧缩放因子:${zoomChangeInfo.oldZoomFactor}`);
console.log(`新缩放因子:${zoomChangeInfo.newZoomFactor}`);
}
browser.tabs.onZoomChange.addListener(handleZoomed);
浏览器兼容性
BCD tables only load in the browser
备注:
该 API 基于 Chromium 的 chrome.tabs
API。此文档来自 Chromium 代码中的 tabs.json
。