omnibox

Ermöglicht Erweiterungen die Implementierung von benutzerdefiniertem Verhalten, wenn der Benutzer in die Adressleiste des Browsers tippt.

Wenn der Benutzer die Adressleiste des Browsers fokussiert und zu tippen beginnt, zeigt der Browser eine Dropdown-Liste mit vorgeschlagenen Seiten basierend auf dem, was er eingegeben hat. Dies bietet dem Benutzer eine schnelle Möglichkeit, beispielsweise Seiten aus seinem Verlauf oder seinen Lesezeichen aufzurufen.

Die omnibox-API bietet der Erweiterung eine Möglichkeit, die in der Dropdown-Liste angezeigten Vorschläge anzupassen, wenn der Benutzer ein von der Erweiterung definiertes Schlüsselwort eingibt. Es funktioniert wie folgt:

1. Zuerst muss die Erweiterung einen "omnibox"-Schlüssel in ihrer manifest.json Datei enthalten, der ein Schlüsselwort definiert.
2. Wenn der Benutzer die Adressleiste fokussiert und das Schlüsselwort gefolgt von einem Leerzeichen eingibt, erhält die Erweiterung ein omnibox.onInputStarted-Ereignis.
3. Optional kann die Erweiterung omnibox.setDefaultSuggestion() aufrufen, um den ersten Vorschlag in der Dropdown-Liste der Adressleiste zu definieren.
4. Während der Benutzer weiterhin Zeichen eingibt, erhält die Erweiterung omnibox.onInputChanged-Ereignisse. Der Ereignislistener erhält den Wert, den der Benutzer eingegeben hat, und kann die Dropdown-Liste der Adressleiste mit Vorschlägen füllen. Wenn die Erweiterung einen Standardvorschlag mit omnibox.setDefaultSuggestion() festlegt, wird dieser Vorschlag zuerst in der Dropdown-Liste angezeigt.
5. Wenn der Benutzer einen Vorschlag akzeptiert, erhält die Erweiterung ein omnibox.onInputEntered-Ereignis. Der Ereignislistener erhält den akzeptierten Vorschlag.
6. Wenn der Benutzer einen Vorschlag löscht, erhält die Erweiterung ein omnibox.onDeleteSuggestion-Ereignis.
7. Wenn der Benutzer die Dropdown-Liste schließt, erhält die Erweiterung ein omnibox.onInputCancelled-Ereignis.