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.

Not: "action" anahtarı manifest dosyasına eklenmemiş olsa bile her uzantının Chrome araç çubuğunda bir simgesi vardır.

{
  "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 seçerek hangi resim ölçeğinin kullanılacağını 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, uzantınızı olası simge görüntüleme boyutu değişikliklerine karşı da 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() yöntemini de ç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ışı Canvas API'sini kullanabilirsiniz.

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}, () => { /* ... */ });

Not: action.setIcon() API'nin amacı statik bir resim ayarlamaktır. Simgeleriniz için animasyonlu resimler kullanmayın.

Sıkıştırılmış uzantılar (.crx dosyasından yüklenen) için resimler, PNG, JPEG, BMP, ICO ve diğerleri dahil olmak üzere Blink oluşturma motorunun görüntüleyebileceği çoğu biçimde olabilir. SVG desteklenmiyor. Paketlenmemiş uzantılar PNG resimleri kullanmalıdır.

İpucu (başlık)

İpucu veya başlık, kullanıcı fare imlecini araç çubuğundaki uzantının simgesinin üzerinde tuttuğunda görünür. Ayrıca, düğme odağa alındığında ekran okuyucular tarafından okunan erişilebilir metne de dahil edilir.

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 sayede, işlemi, uzantının durumuyla ilgili az miktarda bilgi (ör. sayaç) gösterecek şekilde güncelleyebilirsiniz. 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, RGBA rengini oluşturan dört tam sayıdan oluşan bir dizi olabilir 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
  () => { /* ... */ },
);

Pop-up

Kullanıcı, araç çubuğundaki uzantının işlem düğmesini tıkladığında bir işlem pop-up'ı gösterilir. Pop-up istediğiniz herhangi bir HTML içeriğini içerebilir. Bu pop-up, sığacak şekilde otomatik olarak boyutlandırılır kontrol edebilirsiniz. Pop-up'ın boyutu 25x25 ile 800x600 piksel arasında olmalıdır.

Pop-up, başlangıçta manifest.json dosyasındaki "action" anahtarındaki "default_popup" mülkü tarafından ayarlanır. Varsa, bu özellik uzantı içindeki göreli bir yola işaret etmelidir dizin. Ayrıca action.setPopup() yöntemi kullanılarak dinamik olarak farklı bir göreli yola işaret edecek şekilde güncellenebilir.

Not: Uzantı işlemi tarafından pop-up belirtilmişse action.onClicked etkinliği gönderilmez geçerli sekme tıklandığında gösterilir.

Kullanım alanları

Sekme başına durum

Uzantı işlemlerinin her sekme için farklı durumları 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 sekmenin rozet metnini ayarlamak için aşağıdaki gibi bir işlem yapın:

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

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

tabId özelliği atlanırsa ayar, genel ayar olarak değerlendirilir. Sekmeye özel ayarları genel ayarlara göre önceliklidir.

Etkin durum

Araç çubuğu işlemleri varsayılan olarak her sekmede etkindir (tıklanabilir). Bunu action.enable() ve action.disable() yöntemlerini kullanarak kontrol edebilirsiniz. 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 kullanıldığı bazı yaygın durumlara örnekler aşağıda verilmiştir. Bu API'yi denemek için chrome-extension-samples deposundan Action API örneğini yükleyin.

Pop-up göster

Kullanıcı uzantının işlemini tıkladığında uzantını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ın yaygın bir özelliği, uzantının işlemini kullanarak birincil özelliklerini göstermesidir. Aşağıdaki örnekte bu kalıp gösterilmektedir. Kullanıcı işlemi tıkladığında uzantı, mevcut sayfaya bir içerik komut dosyası ekler. Ardından içerik komut dosyası, her şeyin beklendiği gibi çalıştığından emin olmak için bir uyarı gösterir.

// 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 taklit 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ı pencerelerinin üst düzey araç çubuğunda görünür olup olmadığı (yani uzantının kullanıcı tarafından "sabitlenip" sabitlenmediği).

UserSettingsChange

Chrome 130+

Özellikler

• isOnToolbar

  boole isteğe bağlı

  Uzantının işlem simgesinin tarayıcı pencerelerinin üst düzey araç çubuğunda görünür olup olmadığı (yani uzantının kullanıcı tarafından "sabitlenip" sabitlenmediği).

Yöntemler

disable()

Söz 'nı inceleyin.

chrome.action.disable(
  tabId?: number,
  callback?: function,
)

Sekmeyle ilgili işlemi 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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

enable()

Söz 'nı inceleyin.

chrome.action.enable(
  tabId?: number,
  callback?: function,
)

Bir sekme için işlemi 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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getBadgeBackgroundColor()

Promise

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

  • sonuç

    ColorArray

İadeler

• Promise&lt;browserAction.ColorArray&gt;

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getBadgeText()

Söz 'nı inceleyin.

chrome.action.getBadgeText(
  details: TabDetails,
  callback?: function,
)

İşlemin rozet metnini alır. Sekme belirtilmezse sekmeye özgü 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<string>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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

  • sonuç

    ColorArray

İadeler

• Promise&lt;browserAction.ColorArray&gt;

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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<string>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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<string>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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

  • userSettings

    UserSettings

İadeler

• Promise<UserSettings>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

isEnabled()

Söz Chrome 110 ve sonraki sürümler

chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

Uzatma işleminin bir sekme için (veya 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;

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

openPopup()

Promise 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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setBadgeBackgroundColor()

Söz 'nı inceleyin.

chrome.action.setBadgeBackgroundColor(
  details: object,
  callback?: function,
)

Rozetin arka plan rengini ayarlar.

Parametreler

• ayrıntılar

  nesne

  • renk

    dize | ColorArray

    Rozetin RGBA rengini oluşturan [0,255] aralığında dört tam sayı dizisi. Ö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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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 sekme seçildiğinde olacak şekilde 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 iletebilirsiniz ancak alana yalnızca dört karakter sığabilir. Boş bir dize ('') iletilirse rozet metni temizlenir. tabId belirtilir ve text null ise belirtilen sekmenin metni temizlenir ve varsayılan olarak global rozet metni kullanılır.

• geri çağırma

  işlev isteğe bağlı

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

  () => void

İadeler

• Taahhüt<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

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

    dize | ColorArray

    [0,255] aralığındaki dört tam sayıdan oluşan ve rozetin RGBA rengini oluşturan dizi. Örneğin, opak kırmızı [255, 0, 0, 255]'tır. Ayrıca, opak kırmızının #FF0000 veya #F00 olduğu, CSS değeri olan bir dize de olabilir. Bu değer ayarlanmazsa metnin görünür olması için rozet arka plan rengiyle kontrast oluşturan bir renk otomatik olarak seçilir. Alfa değeri 0 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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setIcon()

Promise

chrome.action.setIcon(
  details: object,
  callback?: function,
)

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

Parametreler

• ayrıntılar

  nesne

  • imageData

    ImageData | nesne isteğe bağlı

    Ayarlanacak simgeyi temsil eden bir ImageData nesnesi veya sözlük ({size -> ImageData}). 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ığabilecek 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' koduna dikkat edin 'details.imageData = {'16': foo}' ile eşdeğerdir

  • yol

    string | nesne isteğe bağlı

    Ayarlanacak simgeyi gösteren göreli resim yolu veya sözlük ({size -> relative image path}). 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ığabilecek 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"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<geçersiz>

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

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setPopup()

Promise

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<geçersiz>

  Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setTitle()

Promise

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<geçersiz>

  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

  • sekmesinden

    tabs.Tab

onUserSettingsChanged

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

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

• geri çağırma

  işlev

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

  (change: UserSettingsChange) => void

  • değiştir

    UserSettingsChange