bookmarks.onChildrenReordered
当文件夹中的子项由于在 UI 中排序而更改其顺序时触发。这不会由于调用 bookmarks.move()
或在 UI 中进行拖动操作而触发。
语法
js
browser.bookmarks.onChildrenReordered.addListener(listener)
browser.bookmarks.onChildrenReordered.removeListener(listener)
browser.bookmarks.onChildrenReordered.hasListener(listener)
事件包含以下三个函数:
addListener(listener)
-
添加一个监听器到该事件。
removeListener(listener)
-
停止监听该事件。
listener
参数是要移除的监听器。 hasListener(listener)
-
检查
listener
是否已注册到该事件。如果正在监听,返回true
,否则返回false
。
addListener 语法
参数
listener
-
事件触发时调用的函数。该函数接收以下参数:
id
-
string
。子项重新排序的文件夹的 ID。 reorderInfo
-
object
。包含附加对象的对象。详见 reorderInfo 部分。
附加对象
reorderInfo
childIds
-
string
数组。包含此文件夹中所有书签项的 ID 数组,按照它们现在在 UI 中显示的顺序排列。
浏览器兼容性
BCD tables only load in the browser
示例
js
function handleChildrenReordered(id, reorderInfo) {
console.log(`项目:${id} 子项已重新排序`);
console.log(`子项:${reorderInfo.childIds}`);
}
function handleClick() {
browser.bookmarks.onChildrenReordered.addListener(handleChildrenReordered);
}
browser.browserAction.onClicked.addListener(handleClick);
备注:
此 API 基于 Chromium 的 chrome.bookmarks
API。该文档衍生自 Chromium 代码中的 bookmarks.json
。