Cette page a été traduite par l'API Cloud Translation.

Remplacer les pages Chrome

Les extensions peuvent utiliser des pages de remplacement HTML pour remplacer une page normalement fournie par Google Chrome. Une extension peut contenir un forçage pour l'une des pages suivantes, mais chaque extension ne peut remplacer qu'une seule page:

Gestionnaire de favoris: Page qui s'affiche lorsque l'utilisateur choisit l'élément de menu "Gestionnaire de favoris" dans le menu Chrome ou, sous Mac, le Gestionnaire de favoris dans le menu Favoris. Vous pouvez également accédez à cette page en saisissant l'URL chrome://bookmarks.
Historique: Page qui s'affiche lorsque l'utilisateur sélectionne l'élément de menu "Historique" dans Chrome ou, sur Mac, l'option Afficher l'historique complet du menu Historique. Vous pouvez aussi accéder à cette page en saisissant l'URL chrome://history.
Nouvel onglet: Page qui s'affiche lorsque l'utilisateur crée un onglet ou une fenêtre. Vous pouvez également accéder à cette page en saisissant l'URL chrome://newtab.

Les captures d'écran suivantes montrent la page "Nouvel onglet" par défaut, puis une page "Nouvel onglet" personnalisée.

Pour essayer, consultez nos exemples de remplacement.

Comportement de la fenêtre de navigation privée

Dans les fenêtres de navigation privée, les extensions ne peuvent pas remplacer les pages "Nouvel onglet". Les autres pages fonctionnent toujours si la propriété du fichier manifeste de navigation privée est défini sur "spanning" (valeur par défaut). Pour en savoir plus sur la gestion des fenêtres de navigation privée, consultez Enregistrer des données et le mode navigation privée.

Fichier manifeste

Utilisez le code suivant pour enregistrer une page de remplacement dans le fichier manifeste de l'extension:

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

Remplacez PAGE_TO_OVERRIDE par l'un des éléments suivants:

"bookmarks"
"history"
"newtab"

Bonnes pratiques

Créez une page rapide et compacte.
Les utilisateurs s'attendent à ce que les pages intégrées au navigateur s'ouvrent instantanément. Évitez les tâches qui peuvent prendre beaucoup de temps. en temps réel. Plus précisément, évitez d'accéder aux ressources de base de données de manière synchrone. Lorsque vous effectuez des requêtes réseau, préférez fetch() à XMLHttpRequest().
Pour éviter toute confusion auprès des utilisateurs, donnez un titre à votre page.
Sans titre, le titre de la page est défini par défaut sur l'URL. Spécifiez le titre à l'aide de la balise <title> dans votre fichier HTML.
N'oubliez pas que les nouveaux onglets placent d'abord le curseur sur la barre d'adresse.
Ne vous appuyez pas sur le clavier qui sélectionne par défaut d'autres parties de la page.
Personnalisez la page "Nouvel onglet"
Évitez de créer une page "Nouvel onglet" que les utilisateurs pourraient confondre avec la page "Nouvel onglet" par défaut de Chrome.

Exemples

Consultez les exemples de remplacement.