Substituir páginas do Chrome

As páginas de substituição são uma forma de substituir um arquivo HTML de sua extensão por uma página que o Google O Chrome normalmente oferece. Além do HTML, uma página de substituição geralmente tem código 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 "Gerenciador de favoritos" no menu "Favoritos". Você também pode chegue a 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 Chrome ou, no Mac, o item Mostrar histórico completo no menu Histórico. Você também pode acessar esta 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 nesta página digitando 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 de manifesto anônima seja Definido como "período" (que é o valor padrão). Consulte Como salvar dados e modo de navegação anônima na Visão geral para mais detalhes sobre como lidar com janelas anônimas.

As capturas de tela a seguir mostram a página "Nova guia" padrão e, em seguida, uma página "Nova guia" personalizada.

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 desta maneira:

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

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

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

  • bookmarks
  • history
  • newtab

Dicas

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

  • Deixe sua página rápida e pequena. Os usuários esperam que as páginas integradas ao navegador abram instantaneamente. Evite fazer coisas que podem demorar muito tempo de resposta. Por exemplo, evite buscas síncronas de recursos de banco de dados ou rede.
  • Inclua um título na sua página. Caso contrário, as pessoas poderão ver o URL da página, o que pode ser confuso. Aqui está um exemplo Especificando o título: <title>New Tab</title>
  • Não dependa da página com o foco do teclado. A barra de endereço sempre tem 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 a parte páginas, páginas fechadas recentemente, dicas, uma imagem de plano de fundo de tema etc. ainda não existem. Até se eles fizerem isso, é melhor tentar fazer algo completamente diferente.

Exemplos

Consulte os exemplos de substituição.