browser.fontSettings

Açıklama

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

İzinler

fontSettings

Font Settings API'yi kullanmak için uzantı manifest dosyasında "fontSettings" iznini belirtmeniz 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 belirtilmezse Chrome, "standart" genel yazı tipi ailesi ayarını kullanır.

Bir web sayfası bir dil belirttiğinde Chrome, yazı tipini ilgili dil alfabesinin ayarına göre seçer. Dil belirtilmezse Chrome, varsayılan veya genel komut dosyası ayarını kullanır.

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

Örnekler

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

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

Aşağıdaki snippet, Japonca için sans-serif yazı tipini ayarlar.

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

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

"cursive"

"fantezi"

"math"

LevelOfControl

Şunlardan biri: not\_controllable: Hiçbir uzantı tarafından kontrol edilemez controlled\_by\_other\_extensions: Önceliği daha yüksek olan 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 edilir

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

ISO 15924 alfabe kodu. Varsayılan veya genel alfabe, "Zyyy" alfabe koduyla temsil edilir.

Enum

"Afak"

"Arap"

"Aran"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bas"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Cans"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Gotik"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hang"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Uzuv"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"Google Moon"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palm"

"Perm"

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Runr"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Sund"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Tale"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Tayca"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Yöntemler

clearDefaultFixedFontSize()

browser.fontSettings.clearDefaultFixedFontSize(
  details?: object,
): Promise<void>

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

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

clearDefaultFontSize()

browser.fontSettings.clearDefaultFontSize(
  details?: object,
): Promise<void>

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

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

clearFont()

browser.fontSettings.clearFont(
  details: object,
): Promise<void>

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 temizleneceği alfabe. Atlanırsa global komut dosyası yazı tipi ayarı temizlenir.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

clearMinimumFontSize()

browser.fontSettings.clearMinimumFontSize(
  details?: object,
): Promise<void>

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

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getDefaultFixedFontSize()

browser.fontSettings.getDefaultFixedFontSize(
  details?: object,
): Promise<object>

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

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getDefaultFontSize()

browser.fontSettings.getDefaultFontSize(
  details?: object,
): Promise<object>

Varsayılan yazı tipi boyutunu alır.

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getFont()

browser.fontSettings.getFont(
  details: object,
): Promise<object>

Belirli bir alfabe 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 alfabe. Atlanırsa genel komut dosyasının (komut dosyası kodu "Zyyy") yazı tipi ayarı alınır.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getFontList()

browser.fontSettings.getFontList(): Promise<FontName[]>

Sistemdeki yazı tiplerinin listesini alır.

İadeler

• Promise<FontName[]>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getMinimumFontSize()

browser.fontSettings.getMinimumFontSize(
  details?: object,
): Promise<object>

Minimum yazı tipi boyutunu alır.

Parametreler

• ayrıntılar

  isteğe bağlı nesne

  Bu parametre şu anda kullanılmamaktadır.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

setDefaultFixedFontSize()

browser.fontSettings.setDefaultFixedFontSize(
  details: object,
): Promise<void>

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

Parametreler

• ayrıntılar

  nesne

  • pixelSize

    sayı

    Piksel cinsinden yazı tipi boyutu.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

setDefaultFontSize()

browser.fontSettings.setDefaultFontSize(
  details: object,
): Promise<void>

Varsayılan yazı tipi boyutunu ayarlar.

Parametreler

• ayrıntılar

  nesne

  • pixelSize

    sayı

    Piksel cinsinden yazı tipi boyutu.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

setFont()

browser.fontSettings.setFont(
  details: object,
): Promise<void>

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önüleceği anlamına gelir.

  • genericFamily

    GenericFamily

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

  • alfabe

    ScriptCode isteğe bağlı

    Yazı tipinin ayarlanması gereken alfabe kodu. Atlanırsa genel komut dosyası (komut dosyası kodu "Zyyy") için yazı tipi ayarı yapılır.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

setMinimumFontSize()

browser.fontSettings.setMinimumFontSize(
  details: object,
): Promise<void>

Minimum yazı tipi boyutunu ayarlar.

Parametreler

• ayrıntılar

  nesne

  • pixelSize

    sayı

    Piksel cinsinden yazı tipi boyutu.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

Etkinlikler

onDefaultFixedFontSizeChanged

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

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

Parametreler

• callback

  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üzeyi.

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

onDefaultFontSizeChanged

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

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

Parametreler

• callback

  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üzeyi.

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

onFontChanged

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

Yazı tipi ayarı değiştiğinde tetiklenir.

Parametreler

• callback

  işlev

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

  (details: object) => void

  • ayrıntılar

    nesne

    • fontId

      dize

      Yazı tipi kimliği. Açıklamayı getFont dilinde inceleyin.

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

    • alfabe

      ScriptCode isteğe bağlı

      Yazı tipi ayarının değiştirildiği alfabe kodu.

onMinimumFontSizeChanged

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

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

Parametreler

• callback

  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üzeyi.

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.