Substituir páginas do Chrome

As páginas de substituição são uma maneira de substituir um arquivo HTML da sua extensão por uma página normalmente fornecida pelo Google Chrome. Além de HTML, uma página de substituição geralmente possui códigos CSS e JavaScript.

Uma extensão pode substituir qualquer uma das seguintes páginas:

  • Gerenciador de favoritos:a página que aparece quando o usuário escolhe o item de menu do Gerenciador de favoritos no menu do Google Chrome ou, no Mac, no 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.
Observação:uma única extensão pode substituir apenas uma página. Por exemplo, uma extensão não pode substituir as páginas do Gerenciador de favoritos e do Histórico.

As janelas anônimas são tratadas de forma especial. As páginas "Nova guia" não podem ser substituídas em janelas anônimas. Outras páginas de substituição funcionam em janelas anônimas, desde que a propriedade do manifesto anonymous esteja definida como "spanning", que é o valor padrão. Consulte Como salvar dados e o modo de navegação anônima na Visão geral para mais detalhes sobre como tratar janelas anônimas.

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

Uma página "Nova guia" personalizada

Manifesto

Registre uma página de substituição no manifesto de extensões da seguinte forma:

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

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

Para PAGE_TO_OVERRIDE, substitua uma das seguintes opções:

  • bookmarks
  • history
  • newtab

Dicas

Para uma página de substituição eficaz, siga estas diretrizes:

  • 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. Por exemplo, evite buscas síncronas de recursos de rede ou banco de dados.
  • Inclua um título na página. Caso contrário, as pessoas poderão ver o URL da página, o que poderia ser confuso. Veja um exemplo de como especificar o título: <title>New Tab</title>
  • Não dependa da página que tem o foco do teclado. A barra de endereço sempre recebe o foco primeiro quando o usuário cria uma nova guia.
  • Não tente emular a página "Nova guia" padrão. As APIs necessárias para criar uma versão ligeiramente modificada da página "Nova guia" padrão, com páginas principais, fechadas recentemente, dicas, uma imagem de plano de fundo de tema e assim por diante, ainda não existem. Até que isso aconteça, é melhor tentar fazer algo completamente diferente.

Exemplos

Consulte os exemplos de substituição.