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()
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ümlerVaatler, 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()
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ümlerVaatler, 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()
chrome.fontSettings.clearFont(
details: object,
callback?: function,
)
Bu uzantı tarafından ayarlanan yazı tipini (varsa) temizler.
Parametreler
-
ayrıntılar
nesne
-
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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
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ümlerVaatler, 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()
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
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ümlerVaatler, 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()
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
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
Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.
-
-
İlerlemeler
-
Promise<object>
Chrome 96 ve sonraki sürümlerVaatler, 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()
chrome.fontSettings.getFontList(
callback?: function,
)
Sistemdeki yazı tiplerinin listesini alır.
Parametreler
İlerlemeler
-
Promise<FontName[]>
Chrome 96 ve sonraki sürümlerVaatler, 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()
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
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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ümlerVaatler, 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()
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
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ümlerVaatler, 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()
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ümlerVaatler, 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
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
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
Yazı tipi ayarının değiştiği genel yazı tipi ailesi.
-
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
Bu uzantının, ayar üzerinde sahip olduğu kontrol düzeyidir.
-
pixelSize
sayı
Piksel cinsinden yazı tipi boyutu.
-
-