As extensões podem usar páginas de substituição de HTML para substituir uma página que o Google Chrome normalmente fornece. Uma extensão pode ter uma substituição para qualquer uma das páginas a seguir, mas cada extensão só pode substituir uma página:
- Gerenciador de favoritos
- A página que aparece quando o usuário escolhe o item de menu do Gerenciador de favoritos no menu do Chrome ou, no Mac, o item do Gerenciador de favoritos no menu "Favoritos". Também é possível acessar essa página digitando o URL chrome://bookmarks.
- Histórico
- A página que aparece quando o usuário escolhe o item de menu "Histórico" no menu do Chrome ou, no Mac, "Mostrar histórico completo". Também é possível acessar essa página digitando o URL chrome://history.
- Nova guia
- A página que aparece quando o usuário cria uma nova guia ou janela. Você também pode acessar essa página inserindo o URL chrome://newtab.
As capturas de tela a seguir mostram a página "Nova guia" padrão e uma página "Nova guia" personalizada.
![A página "Nova guia" padrão](https://developer.chrome.google.cn/static/docs/extensions/develop/ui/override-chrome-pages/image/the-default-tab-page-059d30739112b.png?authuser=5&hl=pt)
![Uma página "Nova guia" personalizada](https://developer.chrome.google.cn/static/docs/extensions/develop/ui/override-chrome-pages/image/a-custom-tab-page-d2b577b11a104.png?authuser=5&hl=pt)
Para testar isso, consulte nossos exemplos de substituição.
Comportamento da janela anônima
Em janelas anônimas, as extensões não podem substituir páginas "Nova guia". Outras páginas ainda funcionam se a propriedade de manifesto anonymous estiver definida como "spanning" (o valor padrão). Para saber mais detalhes sobre como lidar com janelas anônimas, consulte Como salvar dados e o modo de navegação anônima.
Manifesto
Use o código a seguir para registrar uma página de substituição no manifesto de extensões:
{
"manifest_version": 3,
"name": "My extension",
...
"chrome_url_overrides" : {
"PAGE_TO_OVERRIDE": "myPage.html"
},
...
}
Para PAGE_TO_OVERRIDE
, substitua uma das seguintes opções:
"bookmarks"
"history"
"newtab"
Práticas recomendadas
Crie uma página rápida e pequena.
Os usuários esperam que as páginas integradas do navegador sejam abertas instantaneamente. Evite fazer coisas que podem levar muito tempo. Especificamente, evite acessar recursos de banco de dados de maneira síncrona. Ao fazer solicitações de rede, dê preferência afetch()
em vez deXMLHttpRequest()
.Para não confundir o usuário, dê um título à página.
Sem um título, o título da página é o URL padrão. Especifique o título usando a tag<title>
no arquivo HTML.Lembre-se de que as novas guias colocam o foco do teclado na barra de endereço primeiro.
Não dependa do padrão de foco do teclado para outras partes da página.Personalize a página "Nova guia".
Evite criar uma página "Nova guia" que os usuários possam confundir com a página "Nova guia" padrão do Chrome.
Exemplos
Consulte os exemplos de substituição.