chrome.action

Açıklama

Google Chrome araç çubuğundaki uzantının simgesini kontrol etmek için chrome.action API'sini kullanın.

İşlem simgeleri, çok amaçlı adres çubuğunun yanındaki tarayıcı araç çubuğunda görüntülenir. Yükleme işleminden sonra uzantılar menüsünde (yapboz parçası simgesi) görünür. Kullanıcılar, uzantı simgenizi araç çubuğuna sabitleyebilir.

Kullanılabilirlik

Chrome 88 ve sonraki sürümler MV3+

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarların manifest dosyasında beyan edilmesi gerekir.

"action"

chrome.action API'yi kullanmak için "manifest_version" olarak 3 belirtin ve şunu ekleyin: manifest dosyanızdaki "action" anahtarını kullanın.

{
  "name": "Action Extension",
  ...
  "action": {
    "default_icon": {              // optional
      "16": "images/icon16.png",   // optional
      "24": "images/icon24.png",   // optional
      "32": "images/icon32.png"    // optional
    },
    "default_title": "Click Me",   // optional, shown in tooltip
    "default_popup": "popup.html"  // optional
  },
  ...
}

"action" anahtarı (alt öğeleriyle birlikte) isteğe bağlıdır. Dahil edilmediğinde, uzantınız uzantının menüsüne erişmek için araç çubuğunda gösterilmeye devam eder. Bu nedenle, her zaman en azından "action" ve "default_icon" anahtarlarını dahil etmenizi öneririz.

Kavramlar ve kullanım

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

Simge

Simge, uzantınızın araç çubuğunda bulunan ana resimdir ve "default_icon" tuşuyla manifestonuzun "action" anahtarı. Simgeler, cihazdan bağımsız 16 piksel (DIP) genişliğinde ve uzun olmalıdır.

"default_icon" anahtarı, boyutların resim yollarına yönelik bir sözlüğüdür. Chrome bu simgeleri kullanır boyutunu seçebilirsiniz. Tam eşleme bulunamazsa Chrome, eşleşmeye en yakın olan kullanılabilir ve resmi sığacak şekilde ölçeklendirir. Bu durum, resim kalitesini etkileyebilir.

Çünkü 1,5x veya 1,2x gibi daha az yaygın ölçek faktörlerine sahip cihazlar simgeleriniz için birden fazla boyut sağlamanızı öneririz. Bu ayrıca uzantınızı olası simge görüntüleme boyutu değişikliklerine karşı korur. Ancak, yalnızca tek bir boyut sağlıyorsanız "default_icon" anahtarı bir bir simgenin yolunu içeren bir dize olarak görünür.

Uzantınızın simgesini programatik olarak ayarlamak için action.setIcon() komutunu da çağırabilirsiniz farklı bir resim yolu belirterek veya HTML tuvalini kullanarak dinamik olarak oluşturulmuş bir simge sağlayarak öğesi veya bir uzantı hizmet çalışanından ayarlanıyorsa ekran dışı tuval API'si.

const canvas = new OffscreenCanvas(16, 16);
const context = canvas.getContext('2d');
context.clearRect(0, 0, 16, 16);
context.fillStyle = '#00FF00';  // Green
context.fillRect(0, 0, 16, 16);
const imageData = context.getImageData(0, 0, 16, 16);
chrome.action.setIcon({imageData: imageData}, () => { /* ... */ });

Paketlenmiş uzantılarda (.crx dosyasından yüklenen), resimler Blink oluşturma motoru (PNG, JPEG, BMP, ICO ve diğerleri dahil) görüntülenebilir. SVG desteklenmiyor. Paketlenmemiş uzantılar PNG resimleri kullanmalıdır.

İpucu (başlık)

Kullanıcı, fare işaretçisini uzantı simgesinin üzerine getirdiğinde ipucu veya başlık araç çubuğunda bulabilirsiniz. Ayrıca, düğme tıklandığında ekran okuyucular tarafından sesli okunan erişilebilir metinde de odaklanacağız.

Varsayılan ipucu, manifest.json öğesindeki "action" anahtarının "default_title" alanı kullanılarak ayarlanır. action.setTitle() öğesini çağırarak bu özelliği programatik olarak da ayarlayabilirsiniz.

Rozet

İşlemler isteğe bağlı olarak bir "rozet" gösterebilir Simgenin üzerine katman olarak yerleştirilmiş bir metin parçasıdır. Bu şekilde şunları yapabilirsiniz: işlemi, uzantının durumuyla ilgili az miktarda bilgi gösterecek şekilde güncelleyin. Mesela sayaç kullanabilirsiniz. Rozetin bir metin bileşeni ve bir arka plan rengi vardır. Yer sınırlı olduğu için Rozet metninde en fazla dört karakter kullanılmasını öneririz.

Rozet oluşturmak için action.setBadgeBackgroundColor() ve action.setBadgeText(). Manifest dosyasında varsayılan bir rozet ayarı yoktur. Rozet rengi değerleri 0 ile 255 arasında, rozeti veya CSS rengi değeri olan bir dize.

chrome.action.setBadgeBackgroundColor(
  {color: [0, 255, 0, 0]},  // Green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: '#00FF00'},  // Also green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: 'green'},  // Also, also green
  () => { /* ... */ },
);

Kullanıcı, uzantıya ait işlem düğmesini tıklayarak işlemin pop-up'ını araç çubuğunda bulabilirsiniz. Pop-up istediğiniz herhangi bir HTML içeriğini içerebilir. Bu pop-up, sığacak şekilde otomatik olarak boyutlandırılır emin olmanız gerekir. Pop-up'ın boyutu 25x25 ile 800x600 piksel arasında olmalıdır.

Pop-up başlangıçta "action" anahtarındaki "default_popup" özelliği tarafından ayarlanır. manifest.json dosyası. Varsa, bu özellik uzantı içindeki göreli bir yola işaret etmelidir dizin. Ayrıca, action.setPopup() yöntemini çağırın.

Kullanım alanları

Sekme başına durum

Uzantı işlemleri, her sekme için farklı durumlara sahip olabilir. Bir kullanıcı için değer belirlemek sekmesinde, action API'sinin ayar yöntemlerinde tabId özelliğini kullanın. Örneğin, belirli bir sekme için rozet metnini ayarlamak isterseniz aşağıdaki gibi bir işlem yapın:

function getTabId() { /* ... */}
function getTabBadge() { /* ... */}

chrome.action.setBadgeText(
  {
    text: getTabBadge(tabId),
    tabId: getTabId(),
  },
  () => { ... }
);

tabId özelliği eklenmezse bu ayar genel ayar olarak değerlendirilir. Sekmeye özel ayarları genel ayarlara göre önceliklidir.

Etkin durumu

Varsayılan olarak, her sekmede araç çubuğu işlemleri etkindir (tıklanabilir). Bunu kontrol etmek için action.enable() ve action.disable() yöntemleri. Bu yalnızca pop-up'ın (varsa) Uzantınıza action.onClicked etkinlik gönderildi; İşlemin varlığını etkilemez. tıklayın.

Örnekler

İşlemlerin uzantılarda yaygın olarak kullanıldığı bazı yöntemlerin örnekleri aşağıda verilmiştir. Bu API'yi denemek için chrome-extension-samples bölümünden İşlem API'si örneğini yükleyin. depodur.

Pop-up göster

Kullanıcı uzantıyla ilgili işlemi tıkladığında uzantıların pop-up göstermesi yaygın bir durumdur. Alıcı: bunu kendi uzantınızda uygulayın, manifest.json sayfanızda pop-up'ı bildirin ve Chrome'un pop-up'ta görüntülemesi gereken içerik.

// manifest.json
{
  "name": "Action popup demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to view a popup",
    "default_popup": "popup.html"
  }
}

<!-- popup.html -->
<!DOCTYPE html>
<html>
<head>
  <style>
    html {
      min-height: 5em;
      min-width: 10em;
      background: salmon;
    }
  </style>
</head>
<body>
  <p>Hello, world!</p>
</body>
</html>

Tıklandığında içerik komut dosyası ekle

Uzantılar için yaygın bir model, birincil özelliklerini uzantının eyleme dökülebilir. Aşağıdaki örnekte bu kalıp gösterilmektedir. Kullanıcı işlemi tıkladığında uzantı, kod, geçerli sayfaya bir içerik komut dosyası ekler. Ardından, içerik komut dosyası, içeriğin doğrulanıp ve her şeyin beklendiği gibi işlediğini gösterdi.

// manifest.json
{
  "name": "Action script injection demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to show an alert"
  },
  "permissions": ["activeTab", "scripting"],
  "background": {
    "service_worker": "background.js"
  }
}

// background.js
chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['content.js']
  });
});

// content.js
alert('Hello, world!');

declarativeContent ile işlemleri emüle etme

Bu örnekte, bir uzantının arka plan mantığının (a) bir işlemi varsayılan olarak nasıl devre dışı bırakabileceği ve (b) İşlemi belirli sitelerde etkinleştirmek için declarativeContent öğesini kullanın.

// service-worker.js

// Wrap in an onInstalled callback to avoid unnecessary work
// every time the service worker is run
chrome.runtime.onInstalled.addListener(() => {
  // Page actions are disabled by default and enabled on select tabs
  chrome.action.disable();

  // Clear all rules to ensure only our expected rules are set
  chrome.declarativeContent.onPageChanged.removeRules(undefined, () => {
    // Declare a rule to enable the action on example.com pages
    let exampleRule = {
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: {hostSuffix: '.example.com'},
        })
      ],
      actions: [new chrome.declarativeContent.ShowAction()],
    };

    // Finally, apply our new array of rules
    let rules = [exampleRule];
    chrome.declarativeContent.onPageChanged.addRules(rules);
  });
});

Türler

OpenPopupOptions

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

Özellikler

  • windowId

    sayı isteğe bağlı

    İşlem pop-up'ının açılacağı pencerenin kimliği. Belirtilmemişse varsayılan olarak o anda etkin olan pencere kullanılır.

TabDetails

Ö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.

UserSettings

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

Bir uzantının işlemiyle ilgili kullanıcı tarafından belirtilen ayarların koleksiyonu.

Özellikler

  • isOnToolbar

    boolean

    Uzantının işlem simgesinin tarayıcı pencerelerinde görünür olup olmadığı üst düzey araç çubuğu (ör. uzantının kullanıcı tarafından 'sabitlenmiş' olup olmadığı).

UserSettingsChange

Beklemede

Özellikler

  • isOnToolbar

    boole isteğe bağlı

    Uzantının işlem simgesinin tarayıcı pencerelerinde görünür olup olmadığı üst düzey araç çubuğu (ör. uzantının kullanıcı tarafından 'sabitlenmiş' olup olmadığı).

Yöntemler

disable()

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

İşlemi bir sekme için devre dışı bırakır.

Parametreler

  • tabId

    sayı isteğe bağlı

    İşlemi 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>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

enable()

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

İşlemi bir sekme için etkinleştirir. İşlemler varsayılan olarak etkindir.

Parametreler

  • tabId

    sayı isteğe bağlı

    İşlemi 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>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getBadgeBackgroundColor()

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

İşlemin arka plan rengini 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: ColorArray) => void

İadeler

  • Promise&lt;browserAction.ColorArray&gt;

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getBadgeText()

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

İşlemin rozet metnini alır. Herhangi bir sekme belirtilmezse sekmeye özel olmayan rozet metni döndürülür. displayActionCountAsBadgeText etkinse declarativeNetRequestFeedback izni mevcut olmadığı veya sekmeye özel rozet metni sağlanmadığı sürece yer tutucu metin döndürülü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>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getBadgeTextColor()

Söz Chrome 110 ve sonraki sürümler 
chrome.action.getBadgeTextColor(
  details: TabDetails,
  callback?: function,
)

İşlemin metin rengini 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: ColorArray) => void

İadeler

  • Promise&lt;browserAction.ColorArray&gt;

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getPopup()

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

Bu işlem 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>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getTitle()

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

İşlemin 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>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getUserSettings()

Söz Chrome 91 ve sonraki sürümler 
chrome.action.getUserSettings(
  callback?: function,
)

Uzantının işlemiyle ilgili kullanıcı tarafından belirtilen ayarları döndürür.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (userSettings: UserSettings) => void

İadeler

  • Promise&lt;UserSettings&gt;

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

isEnabled()

Söz Chrome 110 ve sonraki sürümler 
chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

Uzantı işleminin bir sekme için (veya herhangi bir tabId sağlanmamışsa genel olarak) etkinleştirilip etkinleştirilmediğini belirtir. Yalnızca declarativeContent kullanılarak etkinleştirilen işlemler her zaman yanlış sonucu döndürür.

Parametreler

  • tabId

    sayı isteğe bağlı

    Etkin durumunu kontrol etmek istediğiniz sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    (isEnabled: boolean) => void

    • isEnabled

      boolean

      Uzantı işlemi etkinleştirilirse doğru değerini alır.

İadeler

  • Promise&lt;boolean&gt;

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

openPopup()

Söz Chrome 127 ve sonraki sürümler 
chrome.action.openPopup(
  options?: OpenPopupOptions,
  callback?: function,
)

Uzantının pop-up'ını açar. Chrome 118 ile Chrome 126 arasında bu özellik yalnızca politika tarafından yüklenen uzantılarda kullanılabilir.

Parametreler

  • seçenekler

    OpenPopupOptions isteğe bağlı

    Pop-up'ın açılmasıyla ilgili seçenekleri belirtir.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setBadgeBackgroundColor()

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

Rozetin arka plan rengini ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • renk

      string | ColorArray

      [0,255] aralığındaki dört tam sayıdan oluşan ve rozetin RGBA rengini oluşturan dizi. Örneğin, [255, 0, 0, 255] opak kırmızıdır. Ayrıca, opak kırmızının #FF0000 veya #F00 olduğu, CSS değeri olan bir dize de olabilir.

    • tabId

      sayı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setBadgeText()

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

İşlemin rozet metnini ayarlar. Rozet, simgenin üstünde gösterilir.

Parametreler

  • ayrıntılar

    nesne

    • tabId

      sayı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

    • text (metin)

      dize isteğe bağlı

      İstediğiniz sayıda karakter aktarılabilir, ancak alana en fazla dört karakter sığabilir. Boş bir dize ('') geçilirse rozet metni temizlenir. tabId belirtilirse ve text null ise belirtilen sekmedeki metin temizlenir ve varsayılan olarak genel rozet metnine ayarlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setBadgeTextColor()

Söz Chrome 110 ve sonraki sürümler 
chrome.action.setBadgeTextColor(
  details: object,
  callback?: function,
)

Rozetin metin rengini ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • renk

      string | ColorArray

      [0,255] aralığındaki dört tam sayıdan oluşan ve rozetin RGBA rengini oluşturan dizi. Örneğin, [255, 0, 0, 255] opak kırmızıdır. Ayrıca, opak kırmızının #FF0000 veya #F00 olduğu, CSS değeri olan bir dize de olabilir. Bu değerin ayarlanmaması durumunda, otomatik olarak rozetin arka plan rengiyle kontrast oluşturan bir renk seçilir ve böylece metin görünür olur. Alfa değeri 0'a eşdeğer olan renkler ayarlanmaz ve hata döndürür.

    • tabId

      sayı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setIcon()

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

İşlemin 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

    • 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ı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

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

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setPopup()

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

Kullanıcı işlemin 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ı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

setTitle()

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

İşlemin başlığını ayarlar. Bu değer, ipucunda gösterilir.

Parametreler

  • ayrıntılar

    nesne

    • tabId

      sayı isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

    • title

      dize

      Fareyle üzerine gelindiğinde işlemin görüntülenmesi gereken dize.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onClicked

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

Bir işlem simgesi tıklandığında tetiklenir. İşlemde 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

onUserSettingsChanged

Beklemede
chrome.action.onUserSettingsChanged.addListener(
  callback: function,
)

Bir uzantının işlem değişikliğiyle ilgili kullanıcı tarafından belirtilen ayarlar olduğunda tetiklenir.

Parametreler