chrome.fontSettings

Açıklama

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

İzinler

fontSettings

Manifest

Yazı Tipi Ayarları API'sini kullanmak için uzantı manifestinde "fontSettings" iznini belirtmeniz gerekir. Örneğin:

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

Genel Yazı Tipi Aileleri ve Komut Dosyaları

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 ailelerine dayanır ve aşağıdaki API referansı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 için ayarı kullanır.

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

Desteklenen dil alfabeleri ISO 15924 alfabe koduyla belirtilir ve aşağıdaki API referansında listelenir. Teknik olarak, Chrome ayarları tamamen komut dosyasına özel değildir. Aynı zamanda dile de bağlıdır. Örneğin, bir web sayfası Rusça dilini belirttiğinde Chrome, Kiril alfabesi için yazı tipi seçer (ISO 15924 alfabe kodu "Cyrl") ve bu yazı tipini yalnızca Kiril alfabesi için değil, yazı tipinin kapsadığı her şey için (ör. Latin) 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); }
);

Aşağıdaki 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ı gösterir.

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

"fantasy"

"math"

LevelOfControl

Bir uzantı 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 edilir

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

ISO 15924 alfabesi kodu. Varsayılan veya genel komut dosyası, "Zyyy" komut dosyası koduyla gösterilir.

Enum

"Afak"

"Arab"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bass"

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

"Goth"

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

"Limb"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"Ay"

"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()

Promise 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<void>

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

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

clearDefaultFontSize()

Promise 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<void>

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

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

clearFont()

Promise 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
): 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 temizlenmesi gereken komut dosyası. Belirtilmezse genel komut dosyası yazı tipi ayarı temizlenir.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

clearMinimumFontSize()

Promise 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<void>

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

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDefaultFixedFontSize()

Promise 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Sabit genişlikli yazı tiplerinin varsayılan boyutunu alır.

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

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

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise<object>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getDefaultFontSize()

Promise 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Varsayılan yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

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

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise<object>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getFont()

Promise 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
): Promise<object>

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

  • callback

    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. Bu, gerçek yazı tipi kimliği tercih değeri yerine, sistemin tercih değerini çözdüğü yazı tipinin kimliği olabilir. Bu nedenle, örneğin yazı tipi sistemde kullanılamıyorsa fontId, setFont'a aktarılan yazı tipinden farklı olabilir. Boş dize, genel komut dosyası yazı tipi ayarına geri dönüşü ifade eder.

      • levelOfControl

        LevelOfControl

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

İadeler

  • Promise<object>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getFontList()

Promise 
chrome.fontSettings.getFontList(
  callback?: function,
): Promise<FontName[]>

Sistemdeki yazı tiplerinin listesini alır.

Parametreler

  • callback

    işlev isteğe bağlı

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

    (results: FontName[]) => void

İadeler

  • Promise<FontName[]>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getMinimumFontSize()

Promise 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Minimum yazı tipi boyutunu alır.

Parametreler

  • ayrıntılar

    object isteğe bağlı

    Bu parametre şu anda kullanılmamaktadır.

  • callback

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

      • pixelSize

        sayı

        Piksel cinsinden yazı tipi boyutu.

İadeler

  • Promise<object>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setDefaultFixedFontSize()

Promise 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
): 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.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setDefaultFontSize()

Promise 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
): Promise<void>

Varsayılan yazı tipi boyutunu ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setFont()

Promise 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
): 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ö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ı (komut dosyası kodu "Zyyy") için yazı tipi ayarı belirlenir.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setMinimumFontSize()

Promise 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
): Promise<void>

Minimum yazı tipi boyutunu ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • pixelSize

      sayı

      Piksel cinsinden yazı tipi boyutu.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onDefaultFixedFontSizeChanged

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

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

chrome.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 bölümünde bulabilirsiniz.

      • genericFamily

        GenericFamily

        Yazı tipi ayarının değiştirildiğ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 komut dosyası kodu.

onMinimumFontSizeChanged

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