pageAction
Lesen und ändern Sie die Attribute der über den Manifest-Schlüssel page_action definierten Schaltfläche in der Adressleiste und reagieren Sie auf Klicks darauf.
Eine Schaltfläche in der Adressleiste ist eine Schaltfläche, die der Adressleiste des Browsers hinzugefügt wird.
Sie können in einem Hintergrundskript auf Klicks auf das Symbol reagieren oder ein Popup festlegen, das beim Klicken auf das Symbol geöffnet wird.
Wenn Sie ein Popup festlegen, definieren Sie dessen Inhalt und Verhalten mit HTML, CSS und JavaScript. JavaScript, das im Popup ausgeführt wird, hat Zugriff auf dieselben WebExtension-APIs wie Ihre Hintergrundskripte. Trotz des Namens pageAction hat der Code der Aktion keinen Zugriff auf den Inhalt der Webseite. Um auf das DOM der Webseite zuzugreifen, müssen Sie ein Content-Skript hinzufügen und mit ihm interagieren.
Die Schaltfläche verfügt außerdem über ein Kontextmenü. Mit der API menus und dem page_action-menus.ContextType können Sie diesem Menü Einträge hinzufügen.
Page Actions sind für Aktionen gedacht, die nur für bestimmte Seiten relevant sind (etwa „den aktuellen Tab als Lesezeichen speichern“). Wenn eine Aktion den gesamten Browser betrifft (etwa „alle Lesezeichen anzeigen“), verwenden Sie stattdessen eine Browser Action.
Typen
pageAction.ImageDataType-
Pixeldaten für ein Bild.
Funktionen
pageAction.show()-
Zeigt die Page Action für einen bestimmten Tab an.
pageAction.hide()-
Blendet die Page Action für einen bestimmten Tab aus.
pageAction.isShown()-
Prüft, ob die Page Action angezeigt wird.
pageAction.setTitle()-
Legt den Titel der Page Action fest. Dieser wird in einem Tooltip über der Page Action angezeigt.
pageAction.getTitle()-
Gibt den Titel der Page Action zurück.
pageAction.setIcon()-
Legt das Symbol der Page Action fest.
pageAction.setPopup()-
Legt die URL für das Popup der Page Action fest.
pageAction.getPopup()-
Gibt die URL für das Popup der Page Action zurück.
pageAction.openPopup()-
Öffnet das Popup der Page Action.
Ereignisse
pageAction.onClicked-
Wird ausgelöst, wenn auf das Symbol einer Page Action geklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Page Action ein Popup hat.
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums API chrome.pageAction. Diese Dokumentation wurde von page_action.json im Chromium-Code abgeleitet.