bookmarks.onChildrenReordered

当文件夹中的子项由于在 UI 中排序而更改其顺序时触发。这不会由于调用 bookmarks.move() 或在 UI 中进行拖动操作而触发。

语法

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

示例

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。