Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Permet aux extensions d'implémenter un comportement personnalisé lorsque l'utilisateur tape dans la barre d'adresse du navigateur.

Lorsque l'utilisateur se concentre sur la barre d'adresse du navigateur et commence à taper, le navigateur affiche une liste déroulante contenant des pages suggérées, en fonction de ce qu'ils ont tapé. Cela permet à l'utilisateur d'accéder rapidement, par exemple, aux pages de son historique ou de ses favoris.

L'API omnibox fournit à l'extension un moyen de personnaliser les suggestions affichées dans la liste déroulante, lorsque l'utilisateur saisit un mot clé défini par l'extension. Cela fonctionne comme suit:...

  1. First, the extension must include an "omnibox" key in its manifest.json file, which defines a keyword.
  2. When the user focuses the address bar and types the keyword, followed by a space, the extension will get an omnibox.onInputStarted event.
  3. Optionally, the extension can call omnibox.setDefaultSuggestion() to define the first suggestion that will be displayed in the address bar drop-down.
  4. As the user continues to type characters after this, the extension will get omnibox.onInputChanged events. The event listener will be passed the current value the user has typed, and will be able to populate the address bar drop-down with suggestions. If the extension set a default suggestion using omnibox.setDefaultSuggestion(), then this will appear first in the drop-down.
  5. If the user accepts a suggestion, the extension will get an omnibox.onInputEntered event. The event listener will be passed the accepted suggestion.
  6. If the user dismisses the drop-down, the extension will get an omnibox.onInputCancelled event.

Types

omnibox.OnInputEnteredDisposition
Describes the recommended method to handle the selected suggestion: open in the current tab, open in a new foreground tab, or open in a new background tab.
omnibox.SuggestResult
Object representing a suggestion to add to the address bar drop-down.

Functions

omnibox.setDefaultSuggestion()
Defines the first suggestion that appears in the drop-down when the user enters the keyword for your extension, followed by a space.

Events

omnibox.onInputStarted
Fired when a the user focuses the address bar and types your extension's omnibox keyword, followed by a space.
omnibox.onInputChanged
Fired whenever the user's input changes, after they have focused the address bar and typed your extension's omnibox keyword, followed by a space.
omnibox.onInputEntered
Fired when the user accepts one of your extension's suggestions.
omnibox.onInputCancelled
Fired when the user dismisses the address bar drop-down, after they have focused the address bar and typed your extension's omnibox keyword.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
OnInputEnteredDisposition Oui Non52 Non Oui
SuggestResult Oui Non52 * Non Oui
onInputCancelled Oui Non52 Non Oui
onInputChanged Oui Non52 Non Oui
onInputEntered Oui Non52 Non Oui
onInputStarted Oui Non52 Non Oui
setDefaultSuggestion Oui Non52 * Non Oui

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.omnibox.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,