Mengganti halaman Chrome

Ekstensi dapat menggunakan halaman pengganti HTML untuk menggantikan halaman yang biasanya disediakan oleh Google Chrome. Ekstensi dapat berisi penggantian untuk salah satu halaman berikut, tetapi setiap ekstensi hanya dapat mengganti satu halaman:

Pengelola Bookmark
Halaman yang muncul saat pengguna memilih item menu Pengelola Bookmark dari menu Chrome atau, di Mac, item Pengelola Bookmark dari menu Bookmark. Anda juga dapat Buka halaman ini dengan memasukkan URL chrome://bookmarks.
Histori
Halaman yang muncul saat pengguna memilih item menu Histori dari Chrome atau, pada Mac, item {i>Show Full History<i} dari menu {i>History<i}. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://history.
Tab Baru
Halaman yang muncul ketika pengguna membuat tab atau jendela baru. Anda juga dapat menuju halaman ini dengan memasukkan URL chrome://newtab.

Screenshot berikut menampilkan halaman Tab Baru default, lalu halaman Tab Baru kustom.

Halaman tab baru default
Halaman tab baru default.
Halaman tab baru khusus
Halaman tab baru kustom.

Untuk mencobanya, lihat contoh penggantian.

Perilaku jendela Samaran

Di jendela samaran, ekstensi tidak dapat menggantikan halaman Tab Baru. Halaman lain masih berfungsi jika properti manifes incognito ditetapkan tetapkan ke "spanning" (nilai default). Untuk mengetahui detail tentang cara menangani jendela Samaran, lihat Menyimpan data dan mode samaran.

Manifes

Gunakan kode berikut untuk mendaftarkan halaman penggantian di manifes ekstensi:

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

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

Untuk PAGE_TO_OVERRIDE, ganti salah satu opsi berikut:

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

Praktik terbaik

  • Buat halaman yang cepat dan kecil.
    Pengguna berharap halaman browser bawaan dapat langsung dibuka. Hindari melakukan hal-hal yang mungkin memakan waktu lama baik. Khususnya, hindari mengakses resource database secara sinkron. Saat membuat permintaan jaringan, pilih fetch() daripada XMLHttpRequest().

  • Agar pengguna tidak bingung, beri judul halaman Anda.
    Tanpa judul, judul halaman akan ditetapkan secara default ke URL. Tentukan judul menggunakan tag <title> di file HTML Anda.

  • Perlu diingat bahwa tab baru akan memberikan fokus keyboard ke kolom URL terlebih dahulu.
    Jangan mengandalkan fokus keyboard yang ditetapkan secara default ke bagian lain halaman.

  • Jadikan halaman tab baru sesuai dengan keinginan Anda.
    Hindari membuat halaman tab baru yang mungkin membingungkan pengguna dengan halaman tab baru default Chrome.

Contoh

Lihat contoh penggantian.