Zastąp strony Chrome

Rozszerzenia mogą używać stron zastępowania HTML w celu zastąpienia strony normalnie dostępnej w Google Chrome. Rozszerzenie może zawierać zastąpienie na dowolnej z poniższych stron, ale każde rozszerzenie może zastąpić tylko jedną stronę:

Menedżer zakładek

Strona, która wyświetla się, gdy użytkownik wybierze opcję Menedżer zakładek w menu Chrome lub na Macu – element Menedżer zakładek z menu Zakładki. Możesz też otworzyć tę stronę, wpisując adres URL chrome://bookmarks.

Historia

Strona, która wyświetla się, gdy użytkownik wybierze opcję Historia w menu Chrome lub na Macu wybierze polecenie Pokaż całą historię w menu Historia. Tę stronę możesz też otworzyć, wpisując adres URL chrome://history.

Nowa karta

Strona, która pojawia się, gdy użytkownik utworzy nową kartę lub nowe okno. Tę stronę możesz też otworzyć, wpisując adres URL chrome://newtab.

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.

Aby wypróbować tę funkcję, zapoznaj się z przykładami zastępowania.

Działanie okna incognito

W oknach incognito rozszerzenia nie mogą zastępować stron nowej karty. Inne strony będą nadal działać, jeśli właściwość incognito w pliku manifestu jest ustawiona na „spanning” (wartość domyślna). Szczegółowe informacje o obsłudze okien incognito znajdziesz w sekcji Zapisywanie danych i tryb incognito.

Plik manifestu

Aby zarejestrować stronę zastępowania w pliku manifestu rozszerzenia, użyj tego kodu:

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

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

Zamień PAGE_TO_OVERRIDE na jeden z tych elementów:

• "bookmarks"
• "history"
• "newtab"

Sprawdzone metody

• Zadbaj o szybką i małą stronę.
  Użytkownicy oczekują, że wbudowane strony przeglądarki otwierają się natychmiast. Unikaj działań, które mogą zająć dużo czasu. W szczególności unikaj synchronicznego dostępu do zasobów bazy danych. Podczas wysyłania żądań sieciowych preferuj fetch() zamiast XMLHttpRequest().

• Aby nie wprowadzać użytkowników w błąd, nadaj swojej stronie tytuł.
  Jeśli nie masz tytułu, domyślnym tytułem strony jest adres URL. Określ tytuł w pliku HTML za pomocą tagu <title>.

• Pamiętaj, że nowe karty najpierw koncentrują się na pasku adresu, korzystając z klawiatury.
  Nie korzystaj z domyślnego ustawienia zaznaczenia za pomocą klawiatury w innych częściach strony.

• Dostosuj stronę nowej karty do siebie.
  Unikaj tworzenia strony nowej karty, którą użytkownicy mogą pomylić z domyślną stroną nowej karty w Chrome.

Przykłady

Zobacz przykłady zastępowania.