sidebar_action

Typ	`Object`
Verpflichtend	Nein
Manifest-Version	2 oder höher
Beispiel	json `"sidebar_action": { "default_icon": { "16": "button/geo-16.png", "32": "button/geo-32.png" }, "default_title": "My sidebar", "default_panel": "sidebar/sidebar.html", "open_at_install":true }`

Ein Sidebar ist ein Bereich, der auf der linken Seite des Browserfensters neben der Webseite angezeigt wird. Der Browser stellt eine Benutzeroberfläche bereit, die es dem Benutzer ermöglicht, die derzeit verfügbaren Sidebars anzuzeigen und eine Sidebar zur Anzeige auszuwählen.

Der sidebar_action-Schlüssel ermöglicht es Ihnen, die Standard-Eigenschaften für die Sidebar zu definieren. Sie können diese Eigenschaften zur Laufzeit mit der sidebarAction API ändern.

Syntax

Der sidebar_action-Schlüssel ist ein Objekt, das beliebige der unten aufgeführten Eigenschaften haben kann. Die einzige verpflichtende Eigenschaft ist default_panel.

Name	Typ	Beschreibung
`browser_style` Optional Veraltet in Manifest V3.	`Boolean`	Optional, standardmäßig: `true` in Manifest V2 und bis Firefox 115 in Manifest V3. `false` in Manifest V3 ab Firefox 115. Setzen Sie `browser_style` nicht auf true: Dies wird in Manifest V3 ab Firefox 118 nicht unterstützt. Siehe Manifest V3 Migration für `browser_style`. In Firefox kann das Stylesheet unter chrome://browser/content/extension.css oder chrome://browser/content/extension-mac.css auf macOS angesehen werden. Beachten Sie bei der Einstellung von Dimensionen, dass dieses Stylesheet `box-sizing: border-box` setzt (siehe box-sizing).
`default_icon` Optional	`Object` oder `String`	Verwenden Sie dies, um ein oder mehrere Symbole für die Sidebar anzugeben. Das Symbol wird in der Benutzeroberfläche des Browsers zum Öffnen und Schließen der Sidebars angezeigt. Symbole werden als URLs relativ zur manifest.json-Datei angegeben. Sie können eine einzelne Symboldatei angeben, indem Sie hier einen String übergeben: json `"default_icon": "path/to/geo.svg"` Um mehrere Symbole in verschiedenen Größen anzugeben, geben Sie hier ein Objekt an. Der Name jeder Eigenschaft ist die Höhe des Symbols in Pixeln und muss in eine ganze Zahl umwandelbar sein. Der Wert ist die URL. Zum Beispiel: json `"default_icon": { "16": "path/to/geo-16.png", "32": "path/to/geo-32.png" }` Siehe Wahl der Symbolgrößen für weitere Hinweise dazu. Diese Eigenschaft ist optional: Wenn sie ausgelassen wird, erhält die Sidebar kein Symbol.
`default_panel`	`String`	Der Pfad zu einer HTML-Datei, die den Inhalt der Sidebar angibt. Die HTML-Datei kann CSS- und JavaScript-Dateien unter Verwendung von `<link>` und `<script>` Elementen einschließen, genau wie eine normale Webseite. Anders als bei einer normalen Webseite kann JavaScript, das im Panel ausgeführt wird, auf alle WebExtension-APIs zugreifen (natürlich vorausgesetzt, die Erweiterung hat die entsprechenden Berechtigungen). Diese Eigenschaft ist verpflichtend. Dies ist eine lokalisierbare Eigenschaft.
`default_title` Optional	`String`	Titel für die Sidebar. Dieser wird in der Browser-Benutzeroberfläche für die Auflistung und das Öffnen von Sidebars verwendet und wird oben in der Sidebar angezeigt, wenn sie geöffnet ist. Diese Eigenschaft ist optional: Wenn sie ausgelassen wird, ist der Titel der Sidebar der `Name der Erweiterung`. Dies ist eine lokalisierbare Eigenschaft.
`open_at_install` Optional	Boolean	Optional, standardmäßig auf `true` gesetzt. Bestimmt, ob die Sidebar bei der Installation geöffnet werden soll. Das Standardverhalten ist, die Sidebar zu öffnen, wenn die Installation abgeschlossen ist.

Beispiel

json

"sidebar_action": {
  "default_icon": "sidebar.svg",
  "default_title": "My sidebar!",
  "default_panel": "sidebar.html"
}

Für ein Beispiel für eine Erweiterung, die eine Sidebar verwendet, siehe annotate-page.

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden