action
Lesen und Ändern von Attributen sowie das Überwachen von Klicks auf die Browser-Symbolleiste-Taste, die mit dem action Manifest-Schlüssel definiert wird.
Hinweis:
Diese API ist in Manifest V3 oder höher verfügbar. Sie ersetzt die Manifest V2 APIs browserAction und in Chrome und Safari, pageAction.
Eine Browser-Aktion ist eine Schaltfläche in der Symbolleiste des Browsers.
Sie können der Schaltfläche ein Popup zuordnen. Wie eine Webseite wird das Popup mit HTML, CSS und JavaScript spezifiziert. JavaScript, das im Popup läuft, hat Zugriff auf die gleichen WebExtension-APIs wie Ihre Hintergrundskripte, aber sein globaler Kontext ist das Popup, nicht die aktuell im Browser angezeigte Seite. Um Webseiten zu beeinflussen, müssen Sie mit ihnen über Nachrichten kommunizieren.
Wenn Sie ein Popup angeben, wird es angezeigt - und der Inhalt geladen -, wenn der Benutzer auf das Symbol klickt. Wenn Sie kein Popup angeben, wird ein Ereignis an Ihre Erweiterung gesendet, wenn der Benutzer auf das Symbol klickt.
Die Schaltfläche hat auch ein Kontextmenü, und Sie können diesem Menü mit der menus API Elemente hinzufügen, indem Sie den action menus.ContextType verwenden.
Mit der action API können Sie:
action.onClickedverwenden, um auf Klicks auf das Symbol zu hören.- die Eigenschaften des Symbols — Icon, Titel, Popup usw. — abrufen und festlegen. Diese können global über alle Tabs oder für einen Tab durch Übergeben der Tab-ID als zusätzliches Argument gesetzt werden.
Typen
action.ColorArray-
Ein Array aus vier ganzen Zahlen im Bereich von 0-255, das eine RGBA-Farbe definiert.
action.ImageDataType-
Pixel-Daten für ein Bild. Muss ein
ImageDataObjekt sein (zum Beispiel aus einem<canvas>Element).
Funktionen
action.setTitle()-
Setzt den Titel der Browser-Aktion. Dieser wird in einem Tooltip angezeigt.
action.getTitle()-
Ruft den Titel der Browser-Aktion ab.
action.setIcon()-
Setzt das Icon der Browser-Aktion.
action.setPopup()-
Legt das HTML-Dokument fest, das als Popup geöffnet wird, wenn der Benutzer auf das Symbol der Browser-Aktion klickt.
action.getPopup()-
Ruft das HTML-Dokument ab, das als Popup der Browser-Aktion festgelegt wurde.
action.openPopup()-
Öffnet das Popup der Browser-Aktion.
action.setBadgeText()-
Setzt den Text des Badges der Browser-Aktion. Das Badge wird über dem Symbol angezeigt.
action.getBadgeText()-
Ruft den Text des Badges der Browser-Aktion ab.
action.setBadgeBackgroundColor()-
Setzt die Hintergrundfarbe des Badges.
action.getBadgeBackgroundColor()-
Ruft die Hintergrundfarbe des Badges ab.
action.setBadgeTextColor()-
Setzt die Textfarbe des Badges.
action.getBadgeTextColor()-
Ruft die Textfarbe des Badges ab.
action.getUserSettings()-
Ruft die vom Benutzer angegebenen Einstellungen für die Browser-Aktion ab.
action.enable()-
Aktiviert die Browser-Aktion für einen Tab. Standardmäßig sind Browser-Aktionen für alle Tabs aktiviert.
action.disable()-
Deaktiviert die Browser-Aktion für einen Tab, was bedeutet, dass sie nicht angeklickt werden kann, wenn dieser Tab aktiv ist.
action.isEnabled()-
Überprüft, ob die Browser-Aktion aktiviert ist oder nicht.
Ereignisse
action.onClicked-
Wird ausgelöst, wenn auf ein Browser-Aktionssymbol geklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browser-Aktion ein Popup hat.
action.onUserSettingsChanged-
Wird ausgelöst, wenn eine Änderung in den benutzerdefinierten Einstellungen auftritt, die die Aktion einer Erweiterung beeinflussen.
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.action API von Chromium. Diese Dokumentation ist abgeleitet von action.json im Chromium-Code.