Zastępowanie stron Chrome

Strony zastępowania to sposób zastępowania pliku HTML z rozszerzenia stroną wyświetlaną przez Google Chrome. Strona zastępowania zwykle zawiera kod CSS i JavaScript.

Rozszerzenie może zastąpić dowolną z tych stron:

  • Menedżer zakładek: strona, która pojawia się, gdy użytkownik wybierze w menu Chrome pozycję Menedżer zakładek lub element Menedżera zakładek z menu Zakładki na Macu. Możesz też otworzyć tę stronę, wpisując adres URL chrome://bookmarks.
  • Historia: strona, która pojawia się, gdy użytkownik wybierze w menu Chrome opcję „Historia” lub „Pokaż całą historię” w menu Historia na Macu. Tę stronę możesz też otworzyć, wpisując adres URL chrome://history.
  • Nowa karta: strona wyświetlana, gdy użytkownik utworzy nową kartę lub nowe okno. Tę stronę możesz też otworzyć, wpisując adres URL chrome://newtab.
Uwaga: jedno rozszerzenie może zastąpić tylko jedną stronę. Na przykład rozszerzenie nie może zastąpić stron Menedżera zakładek i Historia.

Okna incognito są traktowane w szczególny sposób. W oknach incognito nie można zastąpić stron nowej karty. Inne strony zastępowania działają w oknach incognito, o ile właściwość incognito w pliku manifestu jest ustawiona na „spanning” (jest to wartość domyślna). Więcej informacji na temat postępowania z oknami incognito znajdziesz w artykule Zapisywanie danych i tryb incognito.

Na poniższych zrzutach ekranu widać domyślną stronę nowej karty, a następnie niestandardową stronę nowej karty.

Domyślna strona nowej karty

Niestandardowa strona nowej karty

Plik manifestu

Zarejestruj stronę zastępowania w pliku manifestu rozszerzenia w ten sposób:

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

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

Zamień PAGE_TO_OVERRIDE na jeden z tych elementów:

  • bookmarks
  • history
  • newtab

Wskazówki

Aby skutecznie zastępować ustawienia strony, postępuj zgodnie z tymi wskazówkami:

  • Zadbaj o szybką i małą stronę. Użytkownicy oczekują, że wbudowane strony przeglądarki będą otwierać się natychmiast. Unikaj działań, które mogą zająć dużo czasu. Unikaj na przykład synchronicznego pobierania zasobów sieciowych lub bazy danych.
  • Podaj tytuł na stronie. W przeciwnym razie użytkownicy mogą zobaczyć adres URL strony, co może być mylące. Oto przykład, jak można podać tytuł: <title>New Tab</title>
  • Nie oznaczaj, że na stronie jest zaznaczona klawiatura. Gdy użytkownik tworzy nową kartę, pasek adresu jest zawsze aktywny jako pierwszy.
  • Nie próbuj emulować domyślnej strony nowej karty. Jeszcze nie istnieją interfejsy API niezbędne do utworzenia nieznacznie zmodyfikowanej wersji domyślnej strony nowej karty (górne strony, ostatnio zamknięte strony, wskazówki, obraz tła motywu itd.). Dopóki tego nie zrobią, lepiej spróbować stworzyć coś zupełnie innego.

Przykłady

Zobacz przykłady zastępowania.