Override delle pagine Chrome

Le pagine di override sono un modo per sostituire un file HTML della tua estensione con una pagina che Google Normalmente Chrome offre. Oltre all'HTML, una pagina di override di solito include codice CSS e JavaScript.

Un'estensione può sostituire una qualsiasi delle seguenti pagine:

• Gestione preferiti: la pagina che viene visualizzata quando l'utente sceglie la voce di menu Gestione preferiti. dal menu Chrome o, su Mac, dalla voce Gestione Preferiti del menu Preferiti. Puoi anche a questa pagina inserendo l'URL chrome://bookmarks.
• Cronologia: la pagina che viene visualizzata quando l'utente sceglie la voce di menu Cronologia da Chrome. oppure, su Mac, la voce Mostra cronologia completa dal menu Cronologia. Puoi anche visualizzare questa pagina inserendo l'URL chrome://history.
• Nuova scheda:la pagina che viene visualizzata quando l'utente crea una nuova scheda o finestra. Puoi anche inserendo l'URL chrome://newtab.

Le finestre di navigazione in incognito vengono trattate in modo speciale. Le pagine Nuova scheda non possono essere sostituite nelle finestre di navigazione in incognito. Altre pagine di override funzionano nelle finestre di navigazione in incognito, purché la proprietà del file manifest incognito sia imposta su "spanning" (che è il valore predefinito). Leggi la sezione Salvataggio dei dati e modalità di navigazione in incognito nella Panoramica per maggiori dettagli su come trattare le finestre di navigazione in incognito.

I seguenti screenshot mostrano la pagina Nuova scheda predefinita e una pagina Nuova scheda personalizzata.

Manifest

Registra una pagina di override nel manifest dell'estensione in questo modo:

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

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

Per PAGE_TO_OVERRIDE, sostituisci una delle seguenti opzioni:

• bookmarks
• history
• newtab

Suggerimenti

Per una pagina di sostituzione efficace, segui queste linee guida:

• Rendi la tua pagina veloce e di dimensioni ridotte. Gli utenti si aspettano che le pagine del browser integrate si aprano all'istante. Evita di svolgere operazioni che potrebbero richiedere molto tempo nel tempo. Ad esempio, evita i recuperi sincroni di risorse di rete o di database.
• Includi un titolo nella pagina. In caso contrario, gli utenti potrebbero visualizzare l'URL della pagina, il che potrebbe creare confusione. Ecco un esempio di specificando il titolo: <title>New Tab</title>
• Non fare affidamento sul fatto che la pagina abbia lo stato attivo della tastiera. La barra degli indirizzi viene sempre impostata per prima quando l'utente crea una nuova scheda.
• Non provare a emulare la pagina Nuova scheda predefinita. Le API necessarie per creare una versione leggermente modificata della pagina Nuova scheda predefinita, con in alto pagine, pagine chiuse di recente, suggerimenti, un'immagine di sfondo a tema e così via, non esistono ancora. Fino al giorno è meglio provare a creare qualcosa di completamente diverso.

Esempi

Consulta gli esempi di override.