chrome.fontinstellingen

Beschrijving

Gebruik de chrome.fontSettings API om de lettertype-instellingen van Chrome te beheren.

Machtigingen

fontSettings

Manifest

Om de Font Settings API te gebruiken, moet u de machtiging "fontSettings" in het extensiemanifest declareren. Bijvoorbeeld:

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

Generieke lettertypefamilies en scripts

Chrome staat toe dat sommige lettertype-instellingen afhankelijk zijn van bepaalde generieke lettertypefamilies en taalscripts. Zo kan het lettertype voor schreefloos Vereenvoudigd Chinees afwijken van het lettertype voor schreefloos Japans.

De generieke lettertypefamilies die door Chrome worden ondersteund, zijn gebaseerd op CSS-generieke lettertypefamilies en worden vermeld in de onderstaande API-referentie. Wanneer een webpagina een generieke lettertypefamilie specificeert, selecteert Chrome het lettertype op basis van de bijbehorende instelling. Als er geen generieke lettertypefamilie is gespecificeerd, gebruikt Chrome de instelling voor de 'standaard' generieke lettertypefamilie.

Wanneer een webpagina een taal specificeert, selecteert Chrome het lettertype op basis van de instelling voor het bijbehorende schrift. Als er geen taal is gespecificeerd, gebruikt Chrome de instelling voor het standaard- of globale schrift.

De ondersteunde taalscripts worden gespecificeerd door ISO 15924-scriptcode en vermeld in de onderstaande API-referentie. Technisch gezien zijn de instellingen van Chrome niet strikt per script, maar ook afhankelijk van de taal. Chrome kiest bijvoorbeeld het lettertype voor Cyrillisch (ISO 15924-scriptcode "Cyrl") wanneer een webpagina de Russische taal specificeert, en gebruikt dit lettertype niet alleen voor Cyrillisch schrift, maar voor alles wat het lettertype omvat, zoals Latijn.

Voorbeelden

De volgende code haalt het standaardlettertype voor Arabisch op.

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

Het volgende fragment stelt het schreefloze lettertype voor Japans in.

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

Om deze API uit te proberen, installeert u het fontSettings API-voorbeeld uit de chrome-extension-samples repository.

Typen

FontName

Geeft de naam van een lettertype weer.

Eigenschappen

  • Getoond

    snaar

    De weergavenaam van het lettertype.

  • lettertype-ID

    snaar

    Het lettertype-ID.

GenericFamily

Een generiek CSS-lettertype.

Enum

"standaard"

"sansserif"

schreefletter

"vast"

"cursief"

"fantasie"

"wiskunde"

LevelOfControl

Een van not\_controllable : kan niet worden bestuurd door een extensie controlled\_by\_other\_extensions : bestuurd door extensies met hogere prioriteit controllable\_by\_this\_extension : kan worden bestuurd door deze extensie controlled\_by\_this\_extension : bestuurd door deze extensie

Enum

"niet_controleerbaar"

"gecontroleerd_door_andere_extensies"

"bestuurbaar_door_deze_extensie"

"gecontroleerd_door_deze_extensie"

ScriptCode

Een ISO 15924-scriptcode. Het standaard- of globale script wordt weergegeven door scriptcode "Zyyy".

Enum

"Afak"

"Arabisch"

"Armi"

"Armn"

"Vooraf"

"Bali"

"Bamu"

"Bas"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Blikjes"

"Cari"

"Kameel"

"Cher"

"Cirt"

"Copt"

"Kapitein"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dubbel"

"Egyd"

"Egyh"

"Egypte"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Oma"

"Grieks"

"Gujr"

"Goeroe"

"Hangen"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebreeuws"

"Hluw"

"Hmng"

"Opgehangen"

"Inds"

"Ital"

"Java"

"Japan"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latijn"

"Lepc"

"Ledemaat"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Repareren"

"Merc"

"Mero"

"Mlym"

"Maan"

"Mong"

"Mroo"

"Mtei"

"Mijnheer"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orja"

"Osma"

"Palm"

"Permanent"

"Fag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Runn"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Scherf"

"Zonde"

"Sinh"

"Sora"

"Zon"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Verhaal"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Tha"

"Thais"

"Tibet"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Methoden

clearDefaultFixedFontSize()

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

Wist de standaard vaste lettergrootte die door deze extensie is ingesteld, indien van toepassing.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

clearDefaultFontSize()

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

Wist de standaardlettergrootte die door deze extensie is ingesteld, indien van toepassing.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

clearFont()

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

Wist het lettertype dat door deze extensie is ingesteld, indien van toepassing.

Parameters

  • details

    voorwerp

    • generiekFamilie

      GeneriekeFamilie

      Het generieke lettertype waarvoor het lettertype moet worden gewist.

    • script

      ScriptCode optioneel

      Het script waarvoor het lettertype moet worden gewist. Als dit wordt weggelaten, wordt de globale scriptlettertype-instelling gewist.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

clearMinimumFontSize()

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

Wist de minimale lettergrootte die door deze extensie is ingesteld, indien van toepassing.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDefaultFixedFontSize()

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

Haalt de standaardgrootte op voor lettertypen met vaste breedte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retourneren

  • Belofte<object>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getDefaultFontSize()

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

Geeft de standaardlettergrootte weer.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retourneren

  • Belofte<object>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getFont()

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

Haalt het lettertype op voor een bepaald script en een generiek lettertype.

Parameters

  • details

    voorwerp

    • generiekFamilie

      GeneriekeFamilie

      Het generieke lettertype waarvoor het lettertype moet worden opgehaald.

    • script

      ScriptCode optioneel

      Het script waarvoor het lettertype moet worden opgehaald. Indien weggelaten, wordt de lettertype-instelling voor het globale script (scriptcode "Zyyy") opgehaald.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • lettertype-ID

        snaar

        De lettertype-ID. In plaats van de letterlijke voorkeurswaarde voor de lettertype-ID, kan dit de ID zijn van het lettertype waarnaar het systeem de voorkeurswaarde herleidt. fontId kan dus verschillen van het lettertype dat aan setFont wordt doorgegeven, bijvoorbeeld als het lettertype niet beschikbaar is op het systeem. De lege tekenreeks geeft aan dat er wordt teruggevallen op de globale scriptlettertype-instelling.

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

Retourneren

  • Belofte<object>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getFontList()

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

Haalt een lijst op met lettertypen op het systeem.

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (results: FontName[]) => void

Retourneren

  • Belofte< FontName []>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getMinimumFontSize()

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

Geeft de minimale lettergrootte weer.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retourneren

  • Belofte<object>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setDefaultFixedFontSize()

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

Hiermee stelt u de standaardgrootte in voor lettertypen met een vaste breedte.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setDefaultFontSize()

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

Hiermee stelt u de standaardlettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setFont()

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

Hiermee stelt u het lettertype in voor een bepaald script en een generiek lettertype.

Parameters

  • details

    voorwerp

    • lettertype-ID

      snaar

      De lettertype-ID. De lege tekenreeks betekent dat er moet worden teruggevallen op de globale scriptlettertype-instelling.

    • generiekFamilie

      GeneriekeFamilie

      Het generieke lettertype waarvoor het lettertype moet worden ingesteld.

    • script

      ScriptCode optioneel

      De scriptcode waarmee het lettertype moet worden ingesteld. Indien weggelaten, wordt de lettertype-instelling voor het globale script (scriptcode "Zyyy") ingesteld.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setMinimumFontSize()

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

Stelt de minimale lettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onDefaultFixedFontSizeChanged

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

Wordt geactiveerd wanneer de standaardinstelling voor de vaste lettergrootte wordt gewijzigd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

onDefaultFontSizeChanged

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

Wordt geactiveerd wanneer de standaardinstelling voor de lettergrootte verandert.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

onFontChanged

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

Wordt geactiveerd wanneer een lettertype-instelling verandert.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • lettertype-ID

        snaar

        De lettertype-ID. Zie de beschrijving in getFont .

      • generiekFamilie

        GeneriekeFamilie

        Het generieke lettertype waarvan de lettertype-instelling is gewijzigd.

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • script

        ScriptCode optioneel

        De scriptcode waarvan de lettertype-instelling is gewijzigd.

onMinimumFontSizeChanged

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

Wordt geactiveerd wanneer de instelling voor de minimale lettergrootte wordt gewijzigd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveau van controle

        Niveau van controle

        De mate van controle die deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.