Zastąp strony Chrome

Rozszerzenia mogą używać stron zastępczych HTML, aby zastąpić stronę, którą zwykle wyświetla Google Chrome. Rozszerzenie może zawierać zastąpienie dla dowolnej z tych stron, ale każde rozszerzenie może zastąpić tylko jedną stronę:

Menedżer zakładek

Strona, która pojawia się, gdy użytkownik kliknie pozycję menu Menedżer zakładek w menu Chrome lub, w przypadku komputerów Mac, pozycję Menedżer zakładek w menu Zakładki. Możesz też otworzyć tę stronę, wpisując adres URL chrome://bookmarks.

Historia

Strona, która pojawia się, gdy użytkownik kliknie menu Historia w Chrome lub, w przypadku komputerów Mac, kliknie opcję Pokaż całą historię w menu Historia. Możesz też otworzyć tę stronę, wpisując adres URL chrome://history.

Nowa karta

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

Na tych zrzutach ekranu widać domyślną stronę Nowa karta, a potem stronę Nowa karta dostosowaną przez użytkownika.

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

Zachowanie okna incognito

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

Plik manifestu

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

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

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

W miejscu wartości PAGE_TO_OVERRIDE wpisz jedną z tych wartości:

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

Sprawdzone metody

• Zadbaj o szybkie wczytywanie się strony i jej niewielki rozmiar.
  Użytkownicy oczekują, że wbudowane strony w przeglądarce otwierają się natychmiast. Unikaj czynności, które mogą zająć dużo czasu. Unikaj w szczególności synchronicznego dostępu do zasobów bazy danych. Gdy wysyłasz żądania sieciowe, preferuj fetch() zamiast XMLHttpRequest().

• Aby uniknąć nieporozumień, nadaj stronie tytuł.
  Jeśli nie podasz tytułu, domyślnie zostanie użyty adres URL. W pliku HTML określ tytuł za pomocą tagu <title>.

• Pamiętaj, że nowe karty najpierw skupiają uwagę na pasku adresu.
  Nie polegaj na tym, że klawiatura będzie domyślnie skupiona na innych częściach strony.

• Spersonalizuj stronę nowej karty.
  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ąpienia.