Ekstensi Manifest V2 dihapus dari Chrome Web Store pada 31 Agustus 2026. Migrasikan ekstensi Anda ke Manifest V3 agar tersedia lagi bagi pengguna.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

chrome.pageAction

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.pageAction API untuk menempatkan ikon di toolbar utama Google Chrome, di sebelah kanan kolom URL. Tindakan halaman mewakili tindakan yang dapat dilakukan di halaman saat ini, tetapi tidak berlaku untuk semua halaman. Tindakan halaman akan berwarna abu-abu saat tidak aktif.

Ketersediaan

&leq; MV2

Beberapa contohnya:

Berlangganan feed RSS halaman ini
Buat slideshow dari foto di halaman ini

Ikon RSS dalam screenshot berikut mewakili tindakan halaman yang memungkinkan Anda berlangganan feed RSS untuk halaman saat ini.

Tindakan halaman tersembunyi akan berwarna abu-abu. Misalnya, feed RSS di bawah berwarna abu-abu, karena Anda tidak dapat berlangganan feed untuk halaman saat ini:

Sebaiknya gunakan tindakan browser, sehingga pengguna selalu dapat berinteraksi dengan ekstensi Anda.

Manifes

Daftarkan tindakan halaman Anda di manifes ekstensi seperti ini:

{
  "name": "My extension",
  ...
  "page_action": {
    "default_icon": {                    // optional
      "16": "images/icon16.png",           // optional
      "24": "images/icon24.png",           // optional
      "32": "images/icon32.png"            // optional
    },
    "default_title": "Google Mail",      // optional; shown in tooltip
    "default_popup": "popup.html"        // optional
  },
  ...
}

Karena perangkat dengan faktor skala yang kurang umum seperti 1,5x atau 1,2x menjadi lebih umum, sebaiknya sediakan beberapa ukuran untuk ikon Anda. Chrome akan memilih yang terdekat dan menskalakannya untuk mengisi ruang 16 dip. Hal ini juga memastikan bahwa jika ukuran tampilan ikon berubah, Anda tidak perlu melakukan pekerjaan tambahan untuk menyediakan ikon yang berbeda. Namun, jika perbedaan ukurannya terlalu ekstrem, penskalaan ini dapat menyebabkan ikon kehilangan detail atau terlihat buram.

Sintaksis lama untuk mendaftarkan ikon default masih didukung:

{
  "name": "My extension",
  ...
  "page_action": {
    ...
    "default_icon": "images/icon32.png"  // optional
    // equivalent to "default_icon": { "32": "images/icon32.png" }
  },
  ...
}

Bagian UI

Seperti tindakan browser, tindakan halaman dapat memiliki ikon, tooltip, dan pop-up; namun, tindakan tersebut tidak dapat memiliki badge. Selain itu, tindakan halaman dapat berwarna abu-abu. Anda dapat menemukan informasi tentang ikon, tooltip, dan pop-up dengan membaca UI tindakan browser.

Anda membuat tindakan halaman muncul dan berwarna abu-abu menggunakan metode pageAction.show dan pageAction.hide. Secara default, tindakan halaman akan berwarna abu-abu. Saat menampilkannya, Anda menentukan tab tempat ikon akan muncul. Ikon akan tetap terlihat hingga tab ditutup atau mulai menampilkan URL yang berbeda (misalnya, karena pengguna mengklik link).

Tips

Untuk dampak visual terbaik, ikuti panduan berikut:

Gunakan tindakan halaman untuk fitur yang hanya sesuai untuk beberapa halaman.
Jangan gunakan tindakan halaman untuk fitur yang sesuai untuk sebagian besar halaman. Sebagai gantinya, gunakan tindakan browser.
Jangan terus-menerus menganimasikan ikon Anda. Merepotkan.

Jenis

ImageDataType

Data piksel untuk gambar. Harus berupa objek ImageData (misalnya, dari elemen canvas).

Jenis

ImageData

TabDetails

Chrome 88+

Properti

tabId

number opsional

ID tab yang akan dikueri statusnya. Jika tidak ada tab yang ditentukan, status non-tab-specific akan ditampilkan.

Metode

getPopup()

Promise

chrome.pageAction.getPopup(
  details: TabDetails,
  callback?: function,
): Promise<string>

Mendapatkan dokumen html yang ditetapkan sebagai pop-up untuk tindakan halaman ini.

Parameter

detail

TabDetails
callback

fungsi opsional

Parameter callback terlihat seperti:
```
(result: string) => void
```
- hasil
  
  string

Hasil

Promise<string>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getTitle()

Promise

chrome.pageAction.getTitle(
  details: TabDetails,
  callback?: function,
): Promise<string>

Mendapatkan judul tindakan halaman.

Parameter

detail

TabDetails
callback

fungsi opsional

Parameter callback terlihat seperti:
```
(result: string) => void
```
- hasil
  
  string

Hasil

Promise<string>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

hide()

Promise

chrome.pageAction.hide(
  tabId: number,
  callback?: function,
): Promise<void>

Menyembunyikan tindakan halaman. Tindakan halaman tersembunyi masih muncul di toolbar Chrome, tetapi berwarna abu-abu.

Parameter

tabId

angka

ID tab yang tindakan halamannya ingin Anda ubah.
callback

fungsi opsional

Chrome 67+

Parameter callback terlihat seperti:
```
() => void
```

Hasil

Promise<void>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setIcon()

Promise

chrome.pageAction.setIcon(
  details: object,
  callback?: function,
): Promise<void>

Menetapkan ikon untuk tindakan halaman. Ikon dapat ditentukan sebagai jalur ke file gambar atau sebagai data piksel dari elemen kanvas, atau sebagai kamus dari salah satunya. Properti path atau imageData harus ditentukan.

Parameter

detail

objek
- iconIndex
  
  number opsional
  
  Tidak digunakan lagi. Argumen ini diabaikan.
- imageData
  
  ImageData | objek opsional
  
  Objek ImageData atau kamus {size -> ImageData} yang mewakili ikon yang akan ditetapkan. Jika ikon ditentukan sebagai kamus, gambar sebenarnya yang akan digunakan dipilih bergantung pada kepadatan piksel layar. Jika jumlah piksel gambar yang sesuai dengan satu unit ruang layar sama dengan scale, gambar dengan ukuran scale * n akan dipilih, dengan n adalah ukuran ikon di UI. Minimal satu gambar harus ditentukan. Perhatikan bahwa 'details.imageData = foo' setara dengan 'details.imageData = {'16': foo}'
- jalur
  
  string | object opsional
  
  Jalur gambar relatif atau kamus {size -> relative image path} yang mengarah ke ikon yang akan ditetapkan. Jika ikon ditentukan sebagai kamus, gambar sebenarnya yang akan digunakan dipilih bergantung pada kepadatan piksel layar. Jika jumlah piksel gambar yang sesuai dengan satu unit ruang layar sama dengan scale, gambar dengan ukuran scale * n akan dipilih, dengan n adalah ukuran ikon di UI. Minimal satu gambar harus ditentukan. Perhatikan bahwa 'details.path = foo' setara dengan 'details.path = {'16': foo}'
- tabId
  
  angka
  
  ID tab yang tindakan halamannya ingin Anda ubah.
callback

fungsi opsional

Parameter callback terlihat seperti:
```
() => void
```

Hasil

Promise<void>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setPopup()

Promise

chrome.pageAction.setPopup(
  details: object,
  callback?: function,
): Promise<void>

Menetapkan dokumen HTML untuk dibuka sebagai jendela pop-up saat pengguna mengklik ikon tindakan halaman.

Parameter

detail

objek
- pop-up
  
  string
  
  Jalur relatif ke file HTML yang akan ditampilkan di jendela pop-up. Jika disetel ke string kosong (''), tidak ada jendela pop-up yang ditampilkan.
- tabId
  
  angka
  
  ID tab yang tindakan halamannya ingin Anda ubah.
callback

fungsi opsional

Chrome 67+

Parameter callback terlihat seperti:
```
() => void
```

Hasil

Promise<void>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

setTitle()

Promise

chrome.pageAction.setTitle(
  details: object,
  callback?: function,
): Promise<void>

Menetapkan judul tindakan halaman. Teks ini ditampilkan dalam tooltip di atas tindakan halaman.

Parameter

detail

objek
- tabId
  
  angka
  
  ID tab yang tindakan halamannya ingin Anda ubah.
- judul
  
  string
  
  String tooltip.
callback

fungsi opsional

Chrome 67+

Parameter callback terlihat seperti:
```
() => void
```

Hasil

Promise<void>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

show()

Promise

chrome.pageAction.show(
  tabId: number,
  callback?: function,
): Promise<void>

Menampilkan tindakan halaman. Tindakan halaman ditampilkan setiap kali tab dipilih.

Parameter

tabId

angka

ID tab yang tindakan halamannya ingin Anda ubah.
callback

fungsi opsional

Chrome 67+

Parameter callback terlihat seperti:
```
() => void
```

Hasil

Promise<void>

Chrome 101+

Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onClicked

chrome.pageAction.onClicked.addListener(
  callback: function,
)

Diaktifkan saat ikon tindakan halaman diklik. Peristiwa ini tidak akan diaktifkan jika tindakan halaman memiliki pop-up.

Parameter

callback

fungsi

Parameter callback terlihat seperti:
```
(tab: tabs.Tab) => void
```
- tab
  
  tabs.Tab

chrome.pageAction Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Deskripsi

Ketersediaan

Manifes

Bagian UI

Tips

Jenis

ImageDataType

Jenis

TabDetails

Properti

Metode

getPopup()

Parameter

Hasil

getTitle()

Parameter

Hasil

hide()

Parameter

Hasil

setIcon()

Parameter

Hasil

setPopup()

Parameter

Hasil

setTitle()

Parameter

Hasil

show()

Parameter

Hasil

Acara

onClicked

Parameter

chrome.pageAction