Les extensions peuvent utiliser des pages de remplacement HTML pour remplacer une page normalement fournie par Google Chrome. Une extension peut contenir un remplacement pour n'importe laquelle 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, l'élément "Gestionnaire de favoris" dans le menu "Favoris". Vous pouvez également accéder à cette page en saisissant l'URL chrome://bookmarks.
- Historique
- Page qui s'affiche lorsque l'utilisateur choisit l'élément de menu "Historique" dans le menu Chrome ou, sous Mac, "Afficher l'historique complet" dans le menu "Historique". Vous pouvez également accéder à cette page en saisissant l'URL chrome://history.
- Nouvel onglet
- Page qui s'affiche lorsque l'utilisateur crée un nouvel onglet ou une nouvelle 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 des fenêtres 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 continuent de fonctionner si la propriété du fichier manifeste de navigation privée est définie 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 utiliser le mode navigation privée.
Manifest
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
Proposez une page rapide et compacte.
Les utilisateurs s'attendent à ce que les pages du navigateur intégré s'ouvrent instantanément. Évitez de faire des choses qui pourraient prendre beaucoup de temps. Plus précisément, évitez d'accéder aux ressources de la base de données de manière synchrone. Lorsque vous effectuez des requêtes réseau, préférezfetch()
à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 le fichier HTML.Rappelez-vous que la barre d'adresse est d'abord sélectionnée pour les nouveaux onglets.
Ne vous fiez pas à la sélection du clavier par défaut sur d'autres parties de la page.Personnalisez la page "Nouvel onglet".
Évitez de créer une page "Nouvel onglet" que les utilisateurs risquent de confondre avec la page "Nouvel onglet" par défaut de Chrome.
Exemples
Consultez les exemples de remplacement.