Страницы переопределения — это способ заменить 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-интерфейсы, необходимые для создания слегка измененной версии стандартной страницы новой вкладки — с главными страницами, недавно закрытыми страницами, подсказками, фоновым изображением темы и т. д. — пока не существуют. Пока они этого не сделают, лучше попытаться сделать что-то совершенно другое.
Примеры
См. примеры переопределения .