Zastąp strony Chrome

Rozszerzenia mogą używać stron zastępujących HTML, aby zastąpić stronę wyświetlaną w Google Chrome. Rozszerzenie może zawierać zastąpienie dla dowolnej z tych stron, ale każde z nich może zastąpić tylko jedną stronę:

Menedżer zakładek
Strona, która pojawia się, gdy użytkownik wybiera w menu pozycję Menedżer zakładek w menu Chrome lub w menu Zakładki na Macu. Możesz też możesz otworzyć tę stronę, wpisując URL chrome://bookmarks.
Historia
Strona, która wyświetla się, gdy użytkownik wybierze w Chrome pozycję menu Historia lub, na Macu, wybierając Pokaż całą historię z menu Historia. Możesz też przejść na tę stronę przez wpisanie adresu URL chrome://history.
Nowa karta
Strona, która wyświetla się, gdy użytkownik tworzy nową kartę lub nowe okno. Możesz też przejść do wpisz adres URL chrome://newtab.

Na poniższych zrzutach ekranu widać domyślną stronę Nowa karta oraz niestandardową stronę Nowa karta.

Domyślna strona nowej karty
Domyślna strona nowej karty.
.
Niestandardowa strona nowej karty
Niestandardowa strona nowej karty.

Aby wypróbować tę funkcję, zobacz przykłady zastępowania.

Działanie okna incognito

W oknach incognito rozszerzenia nie mogą zastępować stron nowej karty. Inne strony nadal działają, jeśli właściwość manifestu incognito jest ustawiona na ustaw na „spanning” (wartość domyślna). Szczegółowe informacje o obsłudze okien incognito znajdziesz w artykule 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"
  },
  ...
}

W miejsce PAGE_TO_OVERRIDE zastąp jeden z tych elementów:

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

Sprawdzone metody

  • Postaraj się, by Twoja strona była szybka i mała.
    Użytkownicy oczekują, że strony wbudowane w przeglądarce będą otwierać się natychmiast. Unikaj wykonywania czynności, które mogą zająć dużo czasu obecnie się znajdujesz. Unikaj synchronicznego dostępu do zasobów baz 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 podasz tytułu, domyślnym tytułem strony będzie adres URL. Określ tytuł za pomocą tagu <title> w pliku HTML.

  • Pamiętaj, że nowe karty najpierw aktywują klawiaturę na pasku adresu.
    Nie używaj domyślnego ustawienia skupienia 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ąpienia.