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ıda "fontSettings" iznini beyan etmeniz gerekir manifest dosyasındaki talimatları uygulayın. Ö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 dile bağlı olmasına izin verir komut dosyaları. Örneğin, sans-serif Basitleştirilmiş Çince için kullanılan yazı tipi, kullanılır.

Chrome'un desteklediği genel yazı tipi aileleri, CSS genel yazı tipi ailelerine dayanır ve GenericReference altında listelenir. Bir web sayfası genel bir yazı tipi ailesi belirttiğinde Chrome, yazı tipini ilgili ayara göre seçin. Genel yazı tipi ailesi belirtilmediyse Chrome "standart" ayarını genel yazı tipi ailesini gösterir.

Bir web sayfasında bir dil belirtildiğinde Chrome, otomatik olarak oluşturulur. Herhangi bir dil belirtilmezse Chrome, varsayılan dil ayarını kullanır. komut dosyası biçimindedir.

Desteklenen dil komut dosyaları ISO 15924 komut dosyası koduyla belirtilir ve ScriptCode. Teknik olarak, Chrome ayarları kesinlikle komut dosyası bazında değildir, dili'ne dokunun. Örneğin, bir web sayfası Rusça dilini belirtmektedir ve bu yazı tipini yalnızca Kiril alfabesi için değil, yazı tipinin yer aldığı her şeyi, örneğin Latince'yi.

Ö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 bölümünden fontSettings API örneğini yükleyin. depodur.

Türler

FontName

Yazı tipi adını temsil eder.

Özellikler

  • görünen ad

    dize

    Yazı tipinin görünen adı.

  • fontId

    dize

    Yazı tipi kimliği.

GenericFamily

CSS genel yazı tipi ailesi.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"sürekli"

"fantezi"

"matematik"

LevelOfControl

Şunlardan biri: not\_controllable: hiçbir uzantı tarafından kontrol edilemez controlled\_by\_other\_extensions: daha yüksek önceliğe sahip uzantılar tarafından kontrol edilir 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 genel komut dosyası, "Zyyy" komut dosyası koduyla temsil edilir.

Enum

"Afak"

"Arap"

"Armi"

"Etkinleştir"

"Avst"

"Bali"

"Bamu"

"Bas"

"Batk"

"Beng"

"Büyük"

"Bopo"

"Bahya"

"Berna"

"Bugi"

"Buhd"

"Cakm"

"Konserveler"

"Cansu"

"Cham"

"Kir"

"Tur"

"Kullan"

"TPG"

"Döngü"

"Kirler"

"Deva"

"Dsrt"

"Çift"

"Rahatsız edici"

"Egy"

"Örnek"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Asla"

"Hani"

"Hano"

"Hans"

"Hant"

"İbranice"

"Selam"

"Hmng"

"Askıya Alın"

"Inds"

"İtalyanca"

"Java"

"Jpan"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Enl"

"Enlem"

"Lepc"

"Kalp"

"Leyla"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Düzelt"

"Merc"

"Mero"

"Mlym"

"Ay"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Sel"

"Orkh"

"Orya"

"Osma"

"Palmiye"

"Perm"

"Saf"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Çalıştırıcı"

"Samr"

"Sara"

"Sarp"

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Paz"

"Sylo"

"Sirk"

"Sire"

"Syrj"

"Sırn"

"Tagb"

"Takr"

"Hikaye"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Tayca"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zeyyy"

Yöntemler

clearDefaultFixedFontSize()

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

Varsa, bu uzantı tarafından ayarlanan varsayılan sabit yazı tipi boyutunu temizler.

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

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

clearDefaultFontSize()

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

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

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

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

clearFont()

Söz 'nı inceleyin.
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 silinmesi gereken komut dosyası. Atlanırsa genel komut dosyası yazı tipi ayarı temizlenir.

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

clearMinimumFontSize()

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

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

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

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

getDefaultFixedFontSize()

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

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

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    işlev 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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise&lt;object&gt;

    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.

getDefaultFontSize()

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

Varsayılan yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    işlev 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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise&lt;object&gt;

    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.

getFont()

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

Belirli bir komut dosyası ve genel yazı tipi ailesi için 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 genel komut dosyası ("Zyyy" komut dosyası kodu) için yazı tipi ayarı alınır.

  • geri çağırma

    işlev 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. Değişmez yazı tipi kimliği tercih değeri yerine, sistemin tercih değerini çözümlediği yazı tipinin kimliği olabilir. Bu nedenle, örneğin yazı tipi sistemde mevcut değilse fontId, setFont işlevine iletilen yazı tipinden farklı olabilir. Boş dize, genel komut dosyası yazı tipi ayarının yedeğini belirtir.

      • levelOfControl

        LevelOfControl

        Bu uzantının bu ayar üzerinde sahip olduğu kontrol düzeyi.

İadeler

  • Promise&lt;object&gt;

    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.

getFontList()

Söz 'nı inceleyin.
chrome.fontSettings.getFontList(
  callback?: function,
)

Sistemdeki yazı tiplerinin listesini alır.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (results: FontName[]) => void

İadeler

  • Promise&lt;FontName[]&gt;

    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.

getMinimumFontSize()

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

Minimum yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    nesne isteğe bağlı

    Bu parametre şu anda kullanılmıyor.

  • geri çağırma

    işlev 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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise&lt;object&gt;

    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.

setDefaultFixedFontSize()

Söz 'nı inceleyin.
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

    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.

setDefaultFontSize()

Söz 'nı inceleyin.
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

    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.

setFont()

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

Belirli bir komut dosyası ve genel yazı tipi ailesi için 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önme 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ı ("Zyyy" komut dosyası kodu) için yazı tipi ayarı yapılı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.

setMinimumFontSize()

Söz 'nı inceleyin.
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

    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.

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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • 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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • 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 açıklamalarına bakın.

      • genericFamily

        GenericFamily

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

      • levelOfControl

        LevelOfControl

        Bu uzantının bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • 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 bu ayar üzerinde sahip olduğu kontrol düzeyi.

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.