Mengganti halaman Chrome

Ekstensi dapat menggunakan laman pengganti HTML untuk menggantikan laman yang biasanya disediakan Google Chrome. Ekstensi dapat berisi penggantian untuk 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 membuka halaman ini dengan memasukkan URL chrome://bookmarks.
Histori
Halaman yang muncul saat pengguna memilih item menu Histori dari menu Chrome atau, di Mac, item Tampilkan Histori Lengkap dari menu Histori. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://history.
Tab Baru
Halaman yang muncul saat pengguna membuat tab atau jendela baru. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://newtab.

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

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

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 obfuscate ditetapkan 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 hal berikut:

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

Praktik terbaik

  • Buat halaman Anda cepat dan kecil.
    Pengguna berharap halaman browser bawaan dapat langsung terbuka. Hindari melakukan hal-hal yang mungkin memerlukan waktu lama. 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 di halaman.

  • Sesuaikan halaman tab baru Anda sendiri.
    Hindari membuat halaman tab baru yang dapat membingungkan pengguna dengan halaman tab baru default Chrome.

Contoh

Lihat contoh penggantian.