İşlemi uygulama

Kullanıcı, genellikle uzantınıza ilişkin işlem simgesi olarak adlandırılan araç çubuğu simgesini tıkladığında yapılan işlemdir. Bir işlem, Action API'yi kullanarak bir uzantı özelliğini çağırır veya bir pop-up açar. Bu sayfada, bir uzantı özelliğinin nasıl çağrılacağı gösterilmektedir. Pop-up kullanmak için Pop-up ekleme konusuna bakın.

İşlemi kaydet

chrome.action API'yi kullanmak için "action" anahtarını uzantının manifest dosyasına ekleyin. Bu alanın isteğe bağlı özelliklerinin tam açıklaması için chrome.action API referansının manifest bölümüne bakın.

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

İşleme yanıt verin

Kullanıcının işlem simgesini tıklaması için bir onClicked işleyici kaydedin. Manifest.json dosyasında kayıtlı bir pop-up varsa bu etkinlik tetiklenmez.

service-worker.js:

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

İşlemi koşullu olarak etkinleştirme

chrome.declarativeContent API, sayfa URL'sine göre veya CSS seçiciler sayfadaki öğelerle eşleştiğinde uzantının işlem simgesini etkinleştirmenizi sağlar. Bir uzantının işlem simgesi devre dışı bırakıldığında simge gri olur. Kullanıcı devre dışı bırakıldı simgesini tıklarsa uzantının içerik menüsü görüntülenir.

Devre dışı bırakılmış işlem simgesi
Devre dışı bırakılmış işlem simgesi.

Aksiyon rozeti

Rozetler, uzantı durumu gibi şeyleri veya kullanıcının işlem yapması gerektiğini belirtmek için işlem simgesinin üzerine yerleştirilen biçimlendirilmiş metin parçalarıdır. Bunu göstermek için Su İçme örneğinde "AÇIK" yazan bir rozet gösterilir. değerini gösterir. Rozetler en fazla dört karakter içerebilir.

Rozetsiz ve rozetli bir uzantı simgesi.
Rozetsiz (solda) ve rozetli (sağda) bir uzantı simgesi.

Rozet metnini chrome.action.setBadgeText() çağrısı yaparak, arka plan rengini de chrome.action.setBadgeBackgroundColor() komutunu çağırarak ayarlayın.

service-worker.js:

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

İpucu

İpuçlarını, manifest.json dosyasında "action" anahtarının altındaki "default_title" alanına kaydedin.

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

Ayrıca action.setTitle()` çağrısı yaparak ipuçlarını ayarlayabilir veya güncelleyebilirsiniz. İpucu ayarlanmadıysa uzantının adı gösterilir.