omnibox
=======

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. Tout d'abord, l'extension doit inclure une clé "omnibox" dans le fichier manifest.json qui définit un mot-clé.
2. Lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot-clé, suivi d'un espace, l'extension recevra un événement `omnibox.onInputStarted`.
3. Facultativement, l'extension peut appeler `omnibox.setDefaultSuggestion()` pour définir la première suggestion qui sera affichée dans la liste déroulante de la barre d'adresse.
4. Comme l'utilisateur continue à taper des caractères après cela, l'extension recevra `omnibox.onInputChanged` événements. L'écouteur d'événement recevra la valeur actuelle que l'utilisateur a saisie et pourra remplir la liste déroulante de la barre d'adresse avec des suggestions. Si l'extension définit une suggestion par défaut en utilisant `omnibox.setDefaultSuggestion()`, elle apparaît en premier dans la liste déroulante.
5. Si l'utilisateur accepte une suggestion, l'extension recevra un événement `omnibox.onInputEntered`. L'écouteur d'événement recevra la suggestion acceptée.
6. Si l'utilisateur supprime la liste déroulante, l'extension recevra un événement `omnibox.onInputCancelled`.
Types
-----

`omnibox.OnInputEnteredDisposition`

Décrit la méthode recommandée pour gérer la suggestion sélectionnée: ouvrir dans l'onglet actuel, ouvrir dans un nouvel onglet de premier plan ou ouvrir dans un nouvel onglet d'arrière-plan.

`omnibox.SuggestResult`

Objet représentant une suggestion à ajouter à la liste déroulante de la barre.

Fonctions
---------

`omnibox.setDefaultSuggestion()`

Définit la première suggestion qui apparaît dans la liste déroulante lorsque l'utilisateur entre le mot clé pour votre extension, suivi d'un espace.

Evénements
----------

`omnibox.onInputStarted`

Lancé lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot clé omnibox de votre extension, suivi d'un espace.

`omnibox.onInputChanged`

Déclenché chaque fois que l'utilisateur change d'entrée, après avoir focalisé la barre d'adresse et tapé le mot clé omnibox de votre extension, suivi d'un espace.

`omnibox.onInputEntered`

Lancé lorsque l'utilisateur accepte l'une des suggestions de votre extension.

`omnibox.onInputCancelled`

Lancé lorsque l'utilisateur supprime la liste déroulante de la barre d'adresse, après avoir défini la barre d'adresse et tapé le mot clé omnibox de votre extension.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Example extensions
------------------

* firefox-code-search

**Note :**

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.