pageAction

Lesen und Ändern von Attributen und Hören auf Klicks auf den mit dem page_action Manifest-Schlüssel definierten Schaltfläche in der Adressleiste.

Eine Adressleistenschaltfläche ist eine Schaltfläche, die zur Adressleiste des Browsers hinzugefügt wird.

Pfotenabdrucksymbol, das eine Seitenaktion darstellt

Sie können im Hintergrundskript auf Klicks auf das Symbol hören oder ein Popup angeben, das geöffnet wird, wenn das Symbol angeklickt wird.

Wenn Sie ein Popup angeben, definieren Sie dessen Inhalt und Verhalten mit HTML, CSS und JavaScript. JavaScript, das im Popup ausgeführt wird, hat Zugang zu denselben WebExtension-APIs wie Ihre Hintergrundskripte. Obwohl es pageAction genannt wird, erhält der Aktionscode keinen Zugang zum Inhalt der Webseite. Um auf den DOM der Webseite zuzugreifen, müssen Sie ein Content Script hinzufügen und mit diesem interagieren.

Die Schaltfläche verfügt auch über ein Kontextmenü, und Sie können mit der menus API Elemente zu diesem Menü hinzufügen, indem Sie den page_action menus.ContextType verwenden.

Seitenaktionen sind für Aktionen gedacht, die nur für bestimmte Seiten relevant sind (wie "aktuellen Tab zu den Lesezeichen hinzufügen"). Wenn sie für den gesamten Browser relevant sind (wie "alle Lesezeichen anzeigen"), verwenden Sie stattdessen eine Browseraktion.

Typen

pageAction.ImageDataType: Pixeldaten für ein Bild.

Funktionen

pageAction.show(): Zeigt die Seitenaktion für einen bestimmten Tab an.
pageAction.hide(): Verbirgt die Seitenaktion für einen bestimmten Tab.
pageAction.isShown(): Überprüft, ob die Seitenaktion angezeigt wird oder nicht.
pageAction.setTitle(): Setzt den Titel der Seitenaktion. Dieser wird in einem Tooltip über der Seitenaktion angezeigt.
pageAction.getTitle(): Ruft den Titel der Seitenaktion ab.
pageAction.setIcon(): Setzt das Symbol der Seitenaktion.
pageAction.setPopup(): Setzt die URL für das Popup der Seitenaktion.
pageAction.getPopup(): Ruft die URL für das Popup der Seitenaktion ab.
pageAction.openPopup(): Öffnet das Popup der Seitenaktion.

Ereignisse

pageAction.onClicked: Wird ausgelöst, wenn auf ein Seitenaktionssymbol geklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Seitenaktion ein Popup hat.

Browser-Kompatibilität

BCD tables only load in the browser

Beispielerweiterungen

Hinweis: Diese API basiert auf der chrome.pageAction API von Chromium. Diese Dokumentation stammt aus page_action.json im Chromium-Code.