Mengganti halaman Chrome

Penggantian halaman adalah cara untuk mengganti file HTML dari ekstensi Anda untuk halaman yang biasanya disediakan oleh Google Chrome. Selain HTML, halaman penggantian biasanya memiliki kode CSS dan JavaScript.

Ekstensi dapat menggantikan salah satu halaman berikut:

  • 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.
  • History: Halaman yang muncul saat pengguna memilih item menu History dari menu Chrome, atau di Mac, item Show Full History dari menu History. 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.
Catatan: Satu ekstensi dapat menggantikan satu halaman saja. Misalnya, ekstensi tidak dapat mengganti halaman Pengelola Bookmark dan Histori.

Jendela Samaran diperlakukan secara khusus. Halaman Tab Baru tidak dapat ditimpa di jendela samaran. Halaman pengganti lainnya berfungsi di jendela samaran selama properti manifes Samaran disetel ke "spanning" (yang merupakan nilai default). Lihat Menyimpan data dan mode samaran di Ringkasan untuk mengetahui detail selengkapnya tentang cara menangani jendela samaran.

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

Halaman tab baru default

Halaman tab baru khusus

Manifes

Daftarkan halaman penggantian dalam manifes ekstensi seperti ini:

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

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

Untuk PAGE_TO_OVERRIDE, ganti salah satu hal berikut:

  • bookmarks
  • history
  • newtab

Tips

Agar halaman penggantian efektif, ikuti panduan berikut:

  • Buat halaman Anda cepat dan kecil. Pengguna berharap halaman browser bawaan langsung terbuka. Hindari melakukan hal-hal yang mungkin memerlukan waktu lama. Misalnya, hindari pengambilan resource jaringan atau database secara sinkron.
  • Sertakan judul di halaman Anda. Jika tidak, orang mungkin akan melihat URL halaman, sehingga dapat membingungkan. Berikut adalah contoh cara menentukan judul: <title>New Tab</title>
  • Jangan mengandalkan halaman yang memiliki fokus keyboard. Kolom URL selalu mendapatkan fokus terlebih dahulu saat pengguna membuat tab baru.
  • Jangan mencoba mengemulasikan halaman Tab Baru default. API yang diperlukan untuk membuat versi halaman Tab Baru default yang sedikit dimodifikasi—dengan halaman teratas, halaman yang baru ditutup, tips, gambar latar tema, dan sebagainya—belum ada. Sebelum itu, sebaiknya Anda mencoba membuat sesuatu yang benar-benar berbeda.

Contoh

Lihat contoh penggantian.