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 语法

参数

监听器

此事件发生时调用的函数。该函数会传递以下参数:

id

string。子项被重新排序的文件夹的 ID。

reorderInfo

object。包含附加对象的对象。有关更多详细信息,请参阅 reorderInfo 部分。

额外对象

reorderInfo

childIds

array of string。包含此文件夹中所有书签项 ID 的数组,顺序与它们现在在 UI 中显示的顺序一致。

示例

js
function handleChildrenReordered(id, reorderInfo) {
  console.log(`Item: ${id} children reordered`);
  console.log(`Children: ${reorderInfo.childIds}`);
}

function handleClick() {
  browser.bookmarks.onChildrenReordered.addListener(handleChildrenReordered);
}

browser.browserAction.onClicked.addListener(handleClick);

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.bookmarks API。本文档源自 Chromium 代码中的 bookmarks.json