chrome.fontSettings

Açıklama

Chrome'un yazı tipi ayarlarını yönetmek için chrome.fontSettings API'yi kullanın.

İzinler

fontSettings

Font Settings API'yi kullanmak için uzantı manifestinde "fontSettings" iznini beyan etmeniz gerekir. Örneğin:

{
  "name": "My Font Settings Extension",
  "description": "Customize your fonts",
  "version": "0.2",
  "permissions": [
    "fontSettings"
  ],
  ...
}

Kavramlar ve kullanım

Chrome, bazı yazı tipi ayarlarının belirli genel yazı tipi ailelerine ve dil komut dosyalarına bağlı olmasına izin verir. Örneğin, sans-serif Basitleştirilmiş Çince için kullanılan yazı tipi, serif Japonca için kullanılan yazı tipinden farklı olabilir.

Chrome tarafından desteklenen genel yazı tipi aileleri, CSS genel yazı tipi ailelerini temel alır ve GenericReference altında listelenir. Bir web sayfası genel bir yazı tipi ailesi belirttiğinde, Chrome yazı tipini ilgili ayara göre seçer. Genel yazı tipi ailesi belirtilmemişse Chrome, "standart" genel yazı tipi ailesine ait ayarı kullanır.

Bir web sayfası bir dil belirttiğinde Chrome, yazı tipini karşılık gelen dil komut dosyasının ayarına göre seçer. Herhangi bir dil belirtilmezse Chrome, varsayılan veya genel komut dosyasının ayarını kullanır.

Desteklenen dil komut dosyaları, ISO 15924 komut dosyası koduyla belirtilir ve ScriptCode altında listelenir. Teknik olarak, Chrome ayarları sadece komut dosyası bazında değildir, aynı zamanda dile bağlıdır. Örneğin, Chrome, bir web sayfasında Rusça belirtildiğinde Kiril yazı tipini (ISO 15924 komut dosyası kodu "Cyrl") seçer ve bu yazı tipini yalnızca Kiril alfabesi için değil, Latin gibi yazı tipi kapsadığı her şey için kullanır.

Örnekler

Aşağıdaki kod Arapça için standart yazı tipini alır.

chrome.fontSettings.getFont(
  { genericFamily: 'standard', script: 'Arab' },
  function(details) { console.log(details.fontId); }
);

Sonraki snippet, Japonca için sans-serif yazı tipini ayarlar.

chrome.fontSettings.setFont(
  { genericFamily: 'sansserif', script: 'Jpan', fontId: 'MS PGothic' }
);

Bu API'yi denemek için chrome-extension-samples deposundan fontSettings API örneğini yükleyin.

Türler

FontName

Yazı tipi adını temsil eder.

Özellikler

  • displayName

    dize

    Yazı tipinin görünen adı.

  • fontId

    dize

    Yazı tipi kimliği.

GenericFamily

CSS genel bir yazı tipi ailesi.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"fantasy"

LevelOfControl

Bir not\_controllable: herhangi bir uzantı tarafından kontrol edilemez controlled\_by\_other\_extensions: daha yüksek önceliğe sahip uzantılar tarafından kontrol ediliyor controllable\_by\_this\_extension: bu uzantı tarafından kontrol edilebilir controlled\_by\_this\_extension: bu uzantı tarafından kontrol ediliyor

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

ISO 15924 komut dosyası kodu. Varsayılan veya global komut dosyası, "Zyyy" komut dosyası koduyla temsil edilir.

Enum

"Afak"

"Armi"

"Avst"

"Bali"

"Bamu"

"Bass"

"Batk"

"Beng"

"Bopo"

"Brah"

"Bugi"

"Buhd"

"Cakm"

"Copt"

"Cprt"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Elba"

"Ethi"

"Geor"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hani"

"Hano"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Inds"

"Java"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Lepc"

"Linb"

"Loma"

"Lydi"

"Mand"

"Mani"

"Maya"

"Merc"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orya"

"Osma"

"Palm"

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Samr"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Sylo"

"Syrc"

"Syrj"

"Takr"

"Tale"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

Yöntemler

clearDefaultFixedFontSize()

Söz 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Bu uzantı tarafından ayarlanan varsayılan sabit yazı tipi boyutunu (varsa) temizler.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

clearDefaultFontSize()

Söz 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

Bu uzantı tarafından ayarlanan varsayılan yazı tipi boyutunu (varsa) temizler.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

clearFont()

Söz 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

Bu uzantı tarafından ayarlanan yazı tipini (varsa) temizler.

Parametreler

  • ayrıntılar

    nesne

    • genericFamily

      GenericFamily

      Yazı tipinin temizlenmesi gereken genel yazı tipi ailesi.

    • alfabe

      ScriptCode isteğe bağlı

      Yazı tipinin temizlenmesi gereken komut dosyası. Atlanırsa genel komut dosyası yazı tipi ayarı temizlenir.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

clearMinimumFontSize()

Söz 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

Bu uzantı tarafından ayarlanan minimum yazı tipi boyutunu (varsa) temizler.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getDefaultFixedFontSize()

Söz 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Sabit genişlikli yazı tipleri için varsayılan boyutu alır.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getDefaultFontSize()

Söz 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

Varsayılan yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getFont()

Söz 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
)

Belirli bir komut dosyası ve genel yazı tipi ailesinin yazı tipini alır.

Parametreler

  • ayrıntılar

    nesne

    • genericFamily

      GenericFamily

      Yazı tipinin alınması gereken genel yazı tipi ailesi.

    • alfabe

      ScriptCode isteğe bağlı

      Yazı tipinin alınması gereken komut dosyası. Atlanırsa global komut dosyasının yazı tipi ayarı ("Zyyy komut dosyası kodu") alınır.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • fontId

        dize

        Yazı tipi kimliği. Yazı tipi kimliği tercih değeri yerine bu, sistemin tercih değerini çözümlediği yazı tipinin kimliği olabilir. Bu nedenle, örneğin yazı tipi sistemde yoksa fontId, setFont için iletilen yazı tipinden farklı olabilir. Boş dize, genel komut dosyası yazı tipi ayarına dönüldüğünü belirtir.

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getFontList()

Söz 
chrome.fontSettings.getFontList(
  callback?: function,
)

Sistemdeki yazı tiplerinin listesini alır.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (results: FontName[])=>void

İlerlemeler

  • Promise<FontName[]>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getMinimumFontSize()

Söz 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

Minimum yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setDefaultFixedFontSize()

Söz 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

Sabit genişlikli yazı tipleri için varsayılan boyutu ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setDefaultFontSize()

Söz 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

Varsayılan yazı tipi boyutunu ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setFont()

Söz 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

Belirli bir komut dosyası ve genel yazı tipi ailesinin yazı tipini ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • fontId

      dize

      Yazı tipi kimliği. Boş dize, genel komut dosyası yazı tipi ayarına geri dönmek anlamına gelir.

    • genericFamily

      GenericFamily

      Yazı tipinin ayarlanması gereken genel yazı tipi ailesi.

    • alfabe

      ScriptCode isteğe bağlı

      Yazı tipinin ayarlanması gereken komut dosyası kodu. Atlanırsa genel komut dosyasının (komut dosyası kodu "Zyyy") yazı tipi ayarı belirlenir.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setMinimumFontSize()

Söz 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

Minimum yazı tipi boyutunu ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onDefaultFixedFontSizeChanged

chrome.fontSettings.onDefaultFixedFontSizeChanged.addListener(
  callback: function,
)

Varsayılan sabit yazı tipi boyutu ayarı değiştiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

onDefaultFontSizeChanged

chrome.fontSettings.onDefaultFontSizeChanged.addListener(
  callback: function,
)

Varsayılan yazı tipi boyutu ayarı değiştiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

onFontChanged

chrome.fontSettings.onFontChanged.addListener(
  callback: function,
)

Bir yazı tipi ayarı değiştiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • fontId

        dize

        Yazı tipi kimliği. getFont dilindeki açıklamaya bakın.

      • genericFamily

        GenericFamily

        Yazı tipi ayarının değiştiği genel yazı tipi ailesi.

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • alfabe

        ScriptCode isteğe bağlı

        Yazı tipi ayarının değiştiği komut dosyası kodu.

onMinimumFontSizeChanged

chrome.fontSettings.onMinimumFontSizeChanged.addListener(
  callback: function,
)

Minimum yazı tipi boyutu ayarı değiştiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (details: object)=>void

    • ayrıntılar

      nesne

      • levelOfControl

        LevelOfControl

        Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.