chrome.pageAction

Açıklama

Google Chrome ana araç çubuğunda, adres çubuğunun sağ tarafındaki simgeleri yerleştirmek için chrome.pageAction API'sini kullanın. Sayfa işlemleri, geçerli sayfada gerçekleştirilebilecek ancak tüm sayfalar için geçerli olmayan işlemleri temsil eder. Sayfa işlemleri etkin değilken devre dışı görünür.

Kullanılabilirlik

≤ MV2

Bazı örnekler:

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

Aşağıdaki ekran görüntüsünde bulunan RSS simgesi, RSS'ye abone olmanızı sağlayan bir sayfa işlemini temsil eder. geçerli sayfa için feed'i seçin.

Gizli sayfa işlemleri gri renkte görünür. Örneğin, aşağıdaki RSS özet akışı devre dışıdır; geçerli sayfanın yayınına abone ol:

Kullanıcıların her zaman tarayıcınızla etkileşimde bulunabilmeleri için lütfen bunun yerine bir tarayıcı işlemi kullanmayı düşünün uzantısına sahip olur.

Manifest

Sayfa işleminizi aşağıdaki gibi uzantı manifestine 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 seyrek ölçeğe sahip cihazlar simgeleriniz için birden fazla boyut sağlamanız önerilir. Chrome en yakın olanı seçip ölçeklendirir boşluk doldurmak için kullanılabilecektir. Bu aynı zamanda, simge görüntüleme boyutunun değiştirilmesi durumunda, farklı simgeler sağlamak için daha fazla işlem yapmanız gerekiyor! Ancak, boyut farkı çok aşırı olursa, bu ölçeklendirme simgede ayrıntıların kaybolmasına 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şlemlerinde olduğu gibi sayfa işlemlerinde de bir simge, ipucu ve pop-up bulunabilir. Rozetleri olamaz. . Ayrıca, sayfa işlemleri devre dışı olabilir. Simgeler hakkında bilgi, ipuçlarını ve pop-up'ları tarayıcı işleminin kullanıcı arayüzü ile ilgili olarak okuyun.

Bir sayfa işleminin pageAction.show ve pageAction.hide yöntem. Sayfa işlemi varsayılan olarak devre dışı görünür. Google Takvim widget'ını simgenin gösterileceği sekmeyi belirtirsiniz. Simge, sekmeye kadar görünür olmaya devam eder kapanması veya farklı bir URL göstermeye başlaması (örneğin, kullanıcının bir bağlantıyı tıklaması nedeniyle).

İpuçları

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

  • Yalnızca birkaç sayfada işe yarayan özellikler için sayfa işlemlerini kullanın.
  • Çoğu sayfada işe yarayan özellikler için sayfa işlemlerini kullanmayın. Tarayıcı işlemlerini kullanın .
  • Simgenize sürekli olarak animasyon yapmayın. Bu sadece can sıkıcı.

Türler

ImageDataType

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

Tür

ImageData

TabDetails

Chrome 88 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • tabId

    sayı isteğe bağlı

    Sorgu durumu için sekmenin kimliği. Herhangi bir sekme belirtilmezse sekmeye özgü olmayan durum döndürülür.

Yöntemler

getPopup()

Söz 'nı inceleyin.
chrome.pageAction.getPopup(
  details: TabDetails,
  callback?: function,
)

Bu sayfa işlemi için pop-up olarak ayarlanan html dokümanını alır.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

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

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<dize>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getTitle()

Söz 'nı inceleyin.
chrome.pageAction.getTitle(
  details: TabDetails,
  callback?: function,
)

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

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

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

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<dize>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

hide()

Söz 'nı inceleyin.
chrome.pageAction.hide(
  tabId: number,
  callback?: function,
)

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

Parametreler

  • tabId

    sayı

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

  • geri çağırma

    işlev isteğe bağlı

    Chrome 67 ve sonraki sürümler 'nı inceleyin.

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setIcon()

Söz 'nı inceleyin.
chrome.pageAction.setIcon(
  details: object,
  callback?: function,
)

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

Parametreler

  • ayrıntılar

    nesne

    • iconIndex

      sayı isteğe bağlı

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

    • resimVerisi

      ImageData | nesne isteğe bağlı

      Bir ImageData nesnesi veya sözlük {size -> Görüntülenecek simgeyi temsil eden ImageData} mevcuttur. Simge sözlük olarak belirtildiyse kullanılacak asıl resim, ekranın piksel yoğunluğuna bağlı olarak seçilir. Bir ekran alanı birimine sığan resim pikseli sayısı scale ise scale * n boyutundaki resim seçilir. Burada n, simgenin kullanıcı arayüzündeki boyutudur. En az bir resim belirtilmelidir. 'details.imageData = foo' koduna dikkat edin 'details.imageData = {'16': foo}' ile eşdeğerdir

    • yol

      string | nesne isteğe bağlı

      Göreli bir görsel yolu veya bir sözlük {size -> göreli görüntü yolu} ayarlanacak simgeye işaret ediyor. Simge sözlük olarak belirtildiyse kullanılacak asıl resim, ekranın piksel yoğunluğuna bağlı olarak seçilir. Bir ekran alanı birimine sığan resim pikseli sayısı scale ise scale * n boyutundaki resim seçilir. Burada n, simgenin kullanıcı arayüzündeki boyutudur. En az bir resim belirtilmelidir. "details.path = foo"nun 'details.path = {'16': foo}' ile eşdeğerdir

    • tabId

      sayı

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setPopup()

Söz 'nı inceleyin.
chrome.pageAction.setPopup(
  details: object,
  callback?: function,
)

Kullanıcı, sayfa işleminin simgesini tıkladığında pop-up olarak açılacak HTML dokümanını 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.

  • geri çağırma

    işlev isteğe bağlı

    Chrome 67 ve sonraki sürümler 'nı inceleyin.

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setTitle()

Söz 'nı inceleyin.
chrome.pageAction.setTitle(
  details: object,
  callback?: function,
)

Sayfa işleminin başlığını ayarlar. Bu, sayfa işleminin üzerindeki 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.

  • geri çağırma

    işlev isteğe bağlı

    Chrome 67 ve sonraki sürümler 'nı inceleyin.

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

show()

Söz 'nı inceleyin.
chrome.pageAction.show(
  tabId: number,
  callback?: function,
)

Sayfa işlemini gösterir. Sekme seçildiğinde sayfa işlemi gösterilir.

Parametreler

  • tabId

    sayı

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

  • geri çağırma

    işlev isteğe bağlı

    Chrome 67 ve sonraki sürümler 'nı inceleyin.

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 101 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Etkinlikler

onClicked

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

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

Parametreler

  • geri çağırma

    işlev

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

    (tab: tabs.Tab) => void