Переопределение страниц Chrome

Страницы переопределения — это способ заменить HTML-файл из вашего расширения на страницу, которую обычно предоставляет Google Chrome. Помимо HTML, страница переопределения обычно содержит код CSS и JavaScript.

Расширение может заменить любую из следующих страниц:

  • Диспетчер закладок: страница, которая появляется, когда пользователь выбирает пункт меню «Диспетчер закладок» в меню Chrome или, на Mac, пункт «Диспетчер закладок» в меню «Закладки». Вы также можете перейти на эту страницу, введя URL-адрес chrome://bookmarks .
  • История: страница, которая появляется, когда пользователь выбирает пункт меню «История» в меню Chrome или, на Mac, пункт «Показать полную историю» в меню «История». Вы также можете перейти на эту страницу, введя URL-адрес chrome://history .
  • Новая вкладка: страница, которая появляется, когда пользователь создает новую вкладку или окно. Вы также можете перейти на эту страницу, введя URL-адрес chrome://newtab .
Примечание. Одно расширение может переопределить только одну страницу . Например, расширение не может переопределять страницы «Диспетчер закладок» и «История».

Окна инкогнито обрабатываются особым образом. Страницы новых вкладок нельзя переопределить в окнах в режиме инкогнито. Другие страницы переопределения работают в окнах в режиме инкогнито, если для свойства манифеста инкогнито установлено значение «охват» (значение по умолчанию). Дополнительные сведения о том, как обращаться с окнами в режиме инкогнито, см. в разделе «Сохранение данных и режим инкогнито» в разделе «Обзор».

На следующих снимках экрана показана страница новой вкладки по умолчанию, а затем пользовательская страница новой вкладки.

Страница новой вкладки по умолчанию

Пользовательская страница новой вкладки

Манифест

Зарегистрируйте страницу переопределения в манифесте расширения следующим образом:

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

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

Вместо PAGE_TO_OVERRIDE замените одно из следующих:

  • bookmarks
  • history
  • newtab

Советы

Чтобы создать эффективную страницу переопределения, следуйте этим рекомендациям:

  • Сделайте свою страницу быстрой и маленькой. Пользователи ожидают, что встроенные страницы браузера будут открываться мгновенно. Избегайте действий, которые могут занять много времени. Например, избегайте синхронной выборки ресурсов сети или базы данных.
  • Добавьте заголовок на свою страницу. В противном случае люди могут увидеть URL-адрес страницы, что может сбить с толку. Вот пример указания заголовка: <title>New Tab</title>
  • Не полагайтесь на то, что страница находится в фокусе клавиатуры. Адресная строка всегда получает фокус первым, когда пользователь создает новую вкладку.
  • Не пытайтесь имитировать страницу новой вкладки по умолчанию. API-интерфейсы, необходимые для создания слегка измененной версии стандартной страницы новой вкладки — с главными страницами, недавно закрытыми страницами, подсказками, фоновым изображением темы и т. д. — пока не существуют. Пока они этого не сделают, вам лучше попытаться сделать что-то совершенно другое.

Примеры

См. примеры переопределения .