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