Override delle pagine Chrome

Avviso: stai visualizzando la versione Manifest V2 ritirata di questo articolo. Consulta Manifest V3 - Override delle pagine di Chrome per l'equivalente MV3. Il Chrome Web Store non accetta più le estensioni Manifest V2. Segui la guida alla migrazione di Manifest V3 per convertire l'estensione in Manifest V3.

Le pagine di override sono un modo per sostituire un file HTML dell'estensione con una pagina fornita normalmente da Google Chrome. Oltre al codice HTML, una pagina di override in genere 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, la voce Gestione Preferiti dal menu Preferiti. Puoi accedere a questa pagina anche inserendo l'URL chrome://bookmarks.
• Cronologia: la pagina che viene visualizzata quando l'utente sceglie la voce di menu Cronologia dal menu Chrome o, su Mac, la voce Mostra cronologia completa dal menu Cronologia. Puoi accedere a questa pagina anche inserendo l'URL chrome://history.
• Nuova scheda:la pagina che viene visualizzata quando l'utente crea una nuova scheda o finestra. Puoi accedere a questa pagina anche inserendo l'URL chrome://newtab.

Nota: una singola estensione può sostituire una sola pagina. Ad esempio, un'estensione non può sostituire entrambe le pagine Gestione Preferiti e Cronologia.

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 manifest incognito sia impostata su "spanning" (che è il valore predefinito). Per ulteriori dettagli su come trattare le finestre di navigazione in incognito, consulta Salvataggio di dati e modalità di navigazione in incognito nella panoramica.

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 nel seguente 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 creare una pagina di override efficace, segui queste linee guida:

• Crea pagine piccole e veloci. Gli utenti si aspettano che le pagine del browser integrate si aprano immediatamente. Evita di svolgere operazioni che potrebbero richiedere molto tempo. Ad esempio, evita recuperi sincroni di risorse di rete o database.
• Includi un titolo nella pagina. In caso contrario, gli utenti potrebbero visualizzare l'URL della pagina, creando confusione. Ecco un esempio di specifica del titolo: <title>New Tab</title>
• Non affidarti all'elemento attivo della tastiera sulla pagina. La barra degli indirizzi viene sempre evidenziata 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 pagine principali, pagine chiuse di recente, suggerimenti, un'immagine di sfondo del tema e così via, non esistono ancora. Finché non lo fanno, è meglio provare a fare qualcosa di completamente diverso.

Esempi

Consulta gli esempi di override.