Remplacement de pages Chrome

Les pages de remplacement permettent de remplacer le fichier HTML de votre extension par une page normalement fournie par Google Chrome. En plus du code HTML, une page de remplacement contient généralement du code CSS et JavaScript.

Une extension peut remplacer l'une des pages suivantes:

  • 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". 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, sur Mac, l'élément "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.
Remarque:Une même extension peut remplacer une seule page. Par exemple, une extension ne peut pas remplacer les pages Gestionnaire de favoris et Historique.

Les fenêtres de navigation privée sont traitées de manière spécifique. Dans les fenêtres de navigation privée, les pages "Nouvel onglet" ne peuvent pas être remplacées. Les autres pages de remplacement fonctionnent dans les fenêtres de navigation privée à condition que la propriété du fichier manifeste de navigation privée soit définie sur "spanning" (valeur par défaut). Pour plus d'informations sur la manière dont vous devez traiter les fenêtres de navigation privée, consultez la section Enregistrer des données et le mode navigation privée dans la section "Présentation".

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

Page "Nouvel onglet" par défaut

Une page "Nouvel onglet" personnalisée

Manifest

Enregistrez une page de remplacement dans le fichier manifeste de l'extension comme suit:

{
  "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

Conseils

Pour définir une page de remplacement effectif, suivez ces consignes:

  • 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. Par exemple, évitez les récupérations synchrones des ressources réseau ou de base de données.
  • Incluez un titre dans votre page. Sinon, les internautes pourraient voir l'URL de la page, ce qui pourrait prêter à confusion. Voici un exemple de spécification du titre: <title>New Tab</title>
  • Ne vous attendez pas à ce que le clavier soit sélectionné sur la page. La barre d'adresse est toujours sélectionnée en premier lorsque l'utilisateur crée un onglet.
  • N'essayez pas d'émuler la page "Nouvel onglet" par défaut. Les API nécessaires pour créer une version légèrement modifiée de la page "Nouvel onglet" par défaut (avec les principales pages, les pages récemment fermées, des conseils, une image de fond de thème, etc.) n'existent pas encore. Tant qu’ils ne le font pas, il vaut mieux essayer de créer quelque chose de complètement différent.

Exemples

Consultez les exemples de remplacement.