Chrome-pagina's overschrijven

Overschrijfpagina's zijn een manier om een ​​HTML-bestand van uw extensie te vervangen door een pagina die Google Chrome normaal gesproken aanbiedt. Naast HTML bevat een overschrijvingspagina meestal CSS- en JavaScript-code.

Een extensie kan een van de volgende pagina's vervangen:

  • Bladwijzerbeheer: de pagina die verschijnt wanneer de gebruiker het menu-item Bladwijzerbeheer kiest in het Chrome-menu of, op een Mac, het item Bladwijzerbeheer in het menu Bladwijzers. U kunt deze pagina ook bereiken door de URL chrome://bookmarks in te voeren.
  • Geschiedenis: de pagina die verschijnt wanneer de gebruiker het menu-item Geschiedenis kiest in het Chrome-menu of, op een Mac, het item Volledige geschiedenis weergeven in het menu Geschiedenis. U kunt deze pagina ook bereiken door de URL chrome://history in te voeren.
  • Nieuw tabblad: de pagina die verschijnt wanneer de gebruiker een nieuw tabblad of venster maakt. U kunt deze pagina ook bereiken door de URL chrome://newtab in te voeren.
Opmerking: Eén enkele extensie kan slechts één pagina overschrijven. Een extensie kan bijvoorbeeld niet zowel de Bladwijzerbeheer- als de Geschiedenispagina's overschrijven.

Incognitovensters worden speciaal behandeld. Nieuwe tabbladpagina's kunnen niet worden overschreven in incognitovensters. Andere overschrijvingspagina's werken in incognitovensters, zolang de eigenschap van het incognitomanifest is ingesteld op 'spanning' (wat de standaardwaarde is). Zie Gegevens opslaan en incognitomodus in het Overzicht voor meer informatie over hoe u met incognitovensters moet omgaan.

De volgende schermafbeeldingen tonen de standaardpagina 'Nieuw tabblad' en vervolgens een aangepaste pagina 'Nieuw tabblad'.

De standaard nieuwe tabbladpagina

Een aangepaste nieuwe tabbladpagina

Manifest

Registreer een overschrijvingspagina in het extensiemanifest als volgt:

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

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

Vervang voor PAGE_TO_OVERRIDE een van de volgende:

  • bookmarks
  • history
  • newtab

Tips

Volg deze richtlijnen voor een effectieve overschrijvingspagina:

  • Maak uw pagina snel en klein. Gebruikers verwachten dat ingebouwde browserpagina's onmiddellijk worden geopend. Vermijd het doen van dingen die lang kunnen duren. Vermijd bijvoorbeeld het synchroon ophalen van netwerk- of databasebronnen.
  • Voeg een titel toe aan uw pagina. Anders kunnen mensen de URL van de pagina zien, wat voor verwarring kan zorgen. Hier is een voorbeeld van het opgeven van de titel: <title>New Tab</title>
  • Vertrouw er niet op dat de pagina de toetsenbordfocus heeft. De adresbalk krijgt altijd als eerste de focus wanneer de gebruiker een nieuw tabblad aanmaakt.
  • Probeer niet de standaardpagina 'Nieuw tabblad' te emuleren. De API's die nodig zijn om een ​​licht gewijzigde versie van de standaardpagina 'Nieuw tabblad' te maken (met hoofdpagina's, onlangs gesloten pagina's, tips, een thema-achtergrondafbeelding, enzovoort) bestaan ​​nog niet. Totdat ze dat doen, kun je beter iets heel anders proberen te maken.

Voorbeelden

Zie de voorbeelden van overschrijvingen .