chrome.pageAction

refresh date: 2026-09-25 robots: noindex

Açıklama

Ana Google Chrome araç çubuğunda, adres çubuğunun sağ tarafına simgeler yerleştirmek için chrome.pageAction API'sini kullanın. Sayfa işlemleri, geçerli sayfada yapılabilen ancak tüm sayfalarda geçerli olmayan işlemleri temsil eder. Sayfa işlemleri etkin olmadığında devre dışı görünür.

Kullanılabilirlik

≤ MV2

Bazı örnekler:

  • Bu sayfanın RSS özet akışına abone olun
  • Bu sayfadaki fotoğraflardan slayt gösterisi oluştur

Aşağıdaki ekran görüntüsünde yer alan RSS simgesi, mevcut sayfanın RSS özet akışına abone olmanızı sağlayan bir sayfa işlemini temsil eder.

Gizli sayfa işlemleri devre dışı olarak görünür. Örneğin, aşağıdaki RSS özet akışı, geçerli sayfanın özet akışına abone olamadığınız için devre dışı bırakılmıştır:

Kullanıcıların uzantınızla her zaman etkileşim kurabilmesi için tarayıcı işlemi kullanabilirsiniz.

Manifest

Sayfa işleminizi uzantı manifestine şu şekilde kaydedin:

{
  "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
  },
  ...
}

1,5x veya 1,2x gibi daha az yaygın ölçeklendirme faktörlerine sahip cihazlar daha yaygın hale geldiğinden simgeleriniz için birden fazla boyut sağlamanız önerilir. Chrome, en yakın olanı seçer ve 16 dip'lik alanı dolduracak şekilde ölçeklendirir. Bu sayede, simge görüntüleme boyutu değişirse farklı simgeler sağlamak için daha fazla çalışma yapmanız gerekmez. Ancak boyut farkı çok fazlaysa bu ölçeklendirme, simgenin ayrıntılarını kaybetmesine veya bulanık görünmesine neden olabilir.

Varsayılan simgeyi kaydetmek için kullanılan eski söz dizimi hâlâ desteklenmektedir:

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

Kullanıcı arayüzünün bölümleri

Tarayıcı işlemleri gibi sayfa işlemlerinde de simge, ipucu ve pop-up olabilir ancak rozetler olamaz. Ayrıca, sayfa işlemleri devre dışı bırakılabilir. Simgeler, ipuçları ve pop-up'lar hakkında bilgi edinmek için tarayıcı işlemi kullanıcı arayüzü ile ilgili bilgileri okuyabilirsiniz.

Sırasıyla pageAction.show ve pageAction.hide yöntemlerini kullanarak sayfa işleminin görünmesini ve devre dışı bırakılmasını sağlayabilirsiniz. Varsayılan olarak, sayfa işlemleri devre dışı bırakılmış olarak görünür. Gösterdiğinizde, simgenin görünmesi gereken sekmeyi belirtirsiniz. Simge, sekme kapatılana veya farklı bir URL görüntülemeye başlayana kadar (ör. kullanıcı bir bağlantıyı tıkladığı için) görünür kalır.

İpuçları

En iyi görsel etki için aşağıdaki yönergeleri uygulayın:

  • Yalnızca birkaç sayfa için anlamlı olan özelliklerde sayfa işlemlerini kullanın.
  • Çoğu sayfada anlamlı olan özellikler için sayfa işlemlerini kullanmayın. Bunun yerine tarayıcı işlemlerini kullanın.
  • Simgenizi sürekli animasyonlu hale getirmeyin. Bu can sıkıcı bir durum.

Türler

ImageDataType

Bir resmin piksel verileri. ImageData nesnesi olmalıdır (örneğin, canvas öğesinden).

Tür

ImageData

TabDetails

Chrome 88+

Özellikler

  • tabId

    number isteğe bağlı

    Durumu sorgulanacak sekmenin kimliği. Sekme belirtilmezse sekmeye özgü olmayan durum döndürülür.

Yöntemler

getPopup()

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

Bu sayfa işlemi için pop-up olarak ayarlanan HTML belgesini alır.

Parametreler

  • ayrıntılar

    TabDetails

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<string>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getTitle()

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

Sayfa işleminin başlığını alır.

Parametreler

  • ayrıntılar

    TabDetails

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<string>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

hide()

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

Sayfa işlemini gizler. Gizli sayfa işlemleri Chrome araç çubuğunda görünmeye devam eder ancak devre dışı bırakılır.

Parametreler

  • tabId

    sayı

    Sayfa işlemini değiştirmek istediğiniz sekmenin kimliği.

  • callback

    function isteğe bağlı

    Chrome 67 ve sonraki sürümler

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setIcon()

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

Sayfa işleminin simgesini ayarlar. Simge, bir resim dosyasının yolu veya bir tuval öğesindeki piksel verileri ya da bunlardan birinin sözlüğü olarak belirtilebilir. path veya imageData özelliği belirtilmelidir.

Parametreler

  • ayrıntılar

    nesne

    • iconIndex

      number isteğe bağlı

      Kullanımdan kaldırıldı. Bu bağımsız değişken yoksayılır.

    • imageData

      ImageData | nesne isteğe bağlı

      Ayarlanacak simgeyi temsil eden bir ImageData nesnesi veya {size -> ImageData} sözlüğü. Simge bir sözlük olarak belirtilirse kullanılacak gerçek resim, ekranın piksel yoğunluğuna göre seçilir. Bir ekran alanı birimine sığan resim piksellerinin sayısı scale ise scale * n boyutunda resim seçilir. Burada n, kullanıcı arayüzündeki simgenin boyutudur. En az bir resim belirtilmelidir. 'details.imageData = foo' ifadesinin 'details.imageData = {'16': foo}' ifadesine eşdeğer olduğunu unutmayın.

    • yol

      string | object isteğe bağlı

      Ayarlanacak simgeyi işaret eden göreli bir resim yolu veya {size -> relative image path} sözlüğü. Simge bir sözlük olarak belirtilirse kullanılacak gerçek resim, ekranın piksel yoğunluğuna göre seçilir. Bir ekran alanı birimine sığan resim piksellerinin sayısı scale ise scale * n boyutunda resim seçilir. Burada n, kullanıcı arayüzündeki simgenin boyutudur. En az bir resim belirtilmelidir. "details.path = foo" ifadesinin "details.path = {'16': foo}" ifadesine eşdeğer olduğunu unutmayın.

    • tabId

      sayı

      Sayfa işlemini değiştirmek istediğiniz sekmenin kimliği.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setPopup()

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

Kullanıcı, sayfa işleminin simgesini tıkladığında açılacak HTML belgesini pop-up olarak ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pop-up

      dize

      Pop-up'ta gösterilecek HTML dosyasının göreli yolu. Boş dizeye ('') ayarlanırsa pop-up gösterilmez.

    • tabId

      sayı

      Sayfa işlemini değiştirmek istediğiniz sekmenin kimliği.

  • callback

    function isteğe bağlı

    Chrome 67 ve sonraki sürümler

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setTitle()

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

Sayfa işleminin başlığını ayarlar. Bu, sayfa işleminin üzerindeki bir ipucunda gösterilir.

Parametreler

  • ayrıntılar

    nesne

    • tabId

      sayı

      Sayfa işlemini değiştirmek istediğiniz sekmenin kimliği.

    • title

      dize

      İpucu dizesi.

  • callback

    function isteğe bağlı

    Chrome 67 ve sonraki sürümler

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

show()

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

Sayfa işlemini gösterir. Sayfa işlemi, sekme her seçildiğinde gösterilir.

Parametreler

  • tabId

    sayı

    Sayfa işlemini değiştirmek istediğiniz sekmenin kimliği.

  • callback

    function isteğe bağlı

    Chrome 67 ve sonraki sürümler

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 101+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onClicked

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

Sayfa işlemi simgesi tıklandığında tetiklenir. Sayfa işleminde pop-up varsa bu etkinlik tetiklenmez.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (tab: tabs.Tab) => void