menus.OnClickData
Informationen, die an den menus.onClicked
Ereignis-Listener übergeben werden, wenn ein Menüpunktelement angeklickt wird.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
bookmarkId
Optional-
string
. Die ID des Lesezeichens, an dem das Kontextmenü angeklickt wurde. -
integer
. Welche Maustaste gedrückt wurde. Die Werte entsprechen denen vonMouseEvent.button
. checked
Optional-
boolean
. Ein Flag, das anzeigt, ob ein Kontrollkästchen oder Rundfunkfeld nach Klicken aktiviert war. editable
-
boolean
. Ein Flag, das anzeigt, ob das Element bearbeitbar ist: zum Beispiel, wenn es sich um eine textarea handelt. frameId
Optional-
integer
. Die ID des Rahmens, in dem das Element angeklickt wurde. Die Rahmen-ID kann in anderen APIs verwendet werden, die Rahmen-IDs akzeptieren, wie z.B.tabs.sendMessage()
. Wenn das Element im obersten Dokumentschicht angeklickt wurde, istframeId
null. Wenn das Element vollständig außerhalb der Seite angeklickt wurde (z.B. imtools_menu
odertab
Kontext), dann istframeId
undefined
. frameUrl
Optional-
string
. Die URL des Rahmens des Elements, bei dem das Kontextmenü angeklickt wurde, wenn es sich in einem Rahmen befand. linkText
Optional-
string
. Wenn das Element ein Link ist, der Text des Links. Wenn der Link keinen Text enthält, wird hier die URL selbst angegeben. linkUrl
Optional-
string
. Wenn das Element ein Link ist, die URL, auf die er verweist. mediaType
Optional-
string
. Eines von "image", "video" oder "audio", wenn das Kontextmenü auf einem dieser Typen von Elementen aktiviert wurde. -
integer
oderstring
. Die ID des angeklickten Menüelements. modifiers
-
array
vonstring
. Ein Array, das alle Modifikatortasten enthält, die beim Anklicken des Elements gedrückt wurden. Mögliche Werte sind: "Alt", "Command", "Ctrl", "MacCtrl" und "Shift". Auf einem Mac, wenn der Benutzer die Steuerungstaste gedrückt hält, werden sowohl "Ctrl" als auch "MacCtrl" eingeschlossen. pageUrl
Optional-
string
. Die URL der Seite, auf der das Menüpunktelement angeklickt wurde. Diese Eigenschaft ist nicht vorhanden, wenn der Klick in einem Kontext erfolgt, in dem es keine aktuelle Seite gibt, wie z.B. bei einer Browseraktion. -
integer
oderstring
. Die übergeordnete ID, falls vorhanden, für das angeklickte Element. selectionText
Optional-
string
. Wenn auf der Seite ein Text ausgewählt wurde, enthält dies den ausgewählten Text. srcUrl
Optional-
string
. Falls vorhanden, dersrc
Wert für das Medium im angeklickten Element. targetElementId
Optional-
integer
. Eine Kennung des Elements, sofern vorhanden, über dem das Kontextmenü erstellt wurde. Verwenden Siemenus.getTargetElement()
im Content-Skript, um das Element zu lokalisieren. Beachten Sie, dass dies nicht das id Attribut des Seitenelements ist. viewType
Optional-
ViewType
. Der Typ der Erweiterungsansicht. wasChecked
Optional-
boolean
. Ein Flag, das anzeigt, ob ein Kontrollkästchen oder Rundfunkfeld vor dem Klicken aktiviert war.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der Chromium-API chrome.contextMenus
. Diese Dokumentation ist abgeleitet von context_menus.json
im Chromium-Code.