menus.getTargetElement()
Gibt das Element für eine gegebene targetElementId zurück.
Diese Methode ist in allen Erweiterungsskript-Kontexten verfügbar (Inhalts-Skripte, Hintergrundseiten und andere Erweiterungsseiten) und gibt das Element für eine gegebene info.targetElementId zurück, vorausgesetzt, das Element existiert noch im Dokument, in dem die Methode aufgerufen wird.
Die Methode funktioniert nur in dem Dokument, das das mit der rechten Maustaste angeklickte Element enthält, und die targetElementId verfällt, wenn der Benutzer ein anderes Kontextmenü öffnet.
Hinweis:
menus.getTargetElement gibt das angeforderte Element nur zurück, wenn es im selben Kontext wie das Dokument, das das Element enthält, aufgerufen wird, zum Beispiel unter Verwendung von Inhalts-Skripten (wie im folgenden Beispiel gezeigt).
Eine Erweiterung benötigt die Berechtigung "menus", um diese API zu verwenden.
Syntax
let elem = browser.menus.getTargetElement(targetElementId);
Parameter
targetElementId-
Die Eigenschaft des
menus.OnClickDataObjekts, das an denmenus.onClickedHandler oder dasmenus.onShownEreignis übergeben wird.
Rückgabewert
Das durch den targetElementId Parameter referenzierte Element. Wenn der targetElementId Parameter nicht gültig ist, gibt die Methode null zurück.
Beispiele
Das folgende Beispiel verwendet die getTargetElement Methode, um das durch die info.targetElementId Eigenschaft referenzierte Element zu erhalten und es anschließend zu entfernen.
browser.menus.create({
title: "Remove element",
documentUrlPatterns: ["*://*/*"],
contexts: [
"audio",
"editable",
"frame",
"image",
"link",
"page",
"password",
"video",
],
onclick(info, tab) {
browser.tabs.executeScript(tab.id, {
frameId: info.frameId,
code: `browser.menus.getTargetElement(${info.targetElementId}).remove();`,
});
},
});
Beispielerweiterungen
Browser-Kompatibilität
Loading…