chrome.fontinstellingen

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

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

Toestemmingen

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"
  ],
  ...
}

Algemene lettertypefamilies en scripts

Chrome biedt de mogelijkheid om bepaalde lettertype-instellingen te laten afhangen van specifieke lettertypefamilies en taalschriften. Zo kan het lettertype voor het schreefloze vereenvoudigde Chinees bijvoorbeeld verschillen van het lettertype voor het schreefloze 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 taalschrift. Als er geen taal is gespecificeerd, gebruikt Chrome de instelling voor het standaard- of globale schrift.

De ondersteunde schriften worden gespecificeerd door de ISO 15924-schriftcode en staan ​​vermeld in de onderstaande API-referentie. Technisch gezien zijn de Chrome-instellingen niet strikt per schrift, maar ook afhankelijk van de taal. Chrome kiest bijvoorbeeld het lettertype voor het Cyrillische schrift (ISO 15924-schriftcode "Cyrl") wanneer een webpagina de Russische taal specificeert, en gebruikt dit lettertype niet alleen voor het Cyrillische schrift, maar voor alles wat het lettertype ondersteunt, zoals het Latijnse schrift.

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 codefragment stelt het schreefloze lettertype in voor Japans.

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

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

Soorten

FontName

Geeft een lettertypenaam weer.

Eigenschappen

  • displayweergave

    snaar

    De weergavenaam van het lettertype.

  • fontId

    snaar

    De lettertype-ID.

GenericFamily

Een generieke CSS-lettertypefamilie.

Enum

"standaard"

"sanserif"

"serif"

"vast"

"cursief"

"fantasie"

"wiskunde"

LevelOfControl

Een van de volgende: not\_controllable : kan niet worden bestuurd door een extensie controlled\_by\_other\_extensions : bestuurd door extensies met een 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"

"controleerbaar_door_deze_extensie"

"gecontroleerd door deze extensie"

ScriptCode

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

Enum

"Afak"

"Arabisch"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bas"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Blikjes"

"Cari"

"Sjam"

"Cher"

"Cirt"

"Copt"

"Kapitein"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egypte"

"Egyh"

"Egypte"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Gotisch"

"Oma"

"Grek"

"Gujr"

"Goeroe"

"Hangen"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

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

"Mroe"

"Mtei"

"Mijnheer"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palm"

"Permanent"

"Fag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Priti"

"Rjng"

"Roro"

"Runner"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Scherf"

"Zonde"

"Sinh"

"Sora"

"Zond"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Verhaal"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thais"

"Tibt"

"Tirh"

"Suiker"

"Vaii"

"Visp"

"Wara"

"Wol"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Methoden

clearDefaultFixedFontSize()

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

Hiermee wordt de standaard vaste lettergrootte die door deze extensie is ingesteld, indien aanwezig, verwijderd.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

clearDefaultFontSize()

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

Hiermee wordt de standaard lettergrootte die door deze extensie is ingesteld, indien aanwezig, verwijderd.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

clearFont()

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

Verwijdert het lettertype dat door deze extensie is ingesteld, indien aanwezig.

Parameters

  • details

    voorwerp

    • generiekeFamilie

      GeneriekeFamilie

      De generieke lettertypefamilie waarvoor het lettertype moet worden gewist.

    • script

      ScriptCode optioneel

      Het script waarvoor het lettertype moet worden gewist. Indien dit veld wordt weggelaten, wordt de algemene scriptlettertype-instelling gewist.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

clearMinimumFontSize()

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

Verwijdert de door deze extensie ingestelde minimale lettergrootte, indien van toepassing.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDefaultFixedFontSize()

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

Hiermee wordt de standaardgrootte voor lettertypen met vaste breedte opgehaald.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.

Retourneert

  • Promise<object>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getDefaultFontSize()

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

Hiermee wordt de standaard lettergrootte ingesteld.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.

Retourneert

  • Promise<object>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getFont()

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

Haalt het lettertype op voor een bepaald schrift en een algemene lettertypefamilie.

Parameters

  • details

    voorwerp

    • generiekeFamilie

      GeneriekeFamilie

      De generieke lettertypefamilie waarvoor het lettertype moet worden opgehaald.

    • script

      ScriptCode optioneel

      Het schrift waarvoor het lettertype moet worden opgehaald. Indien dit wordt weggelaten, wordt de lettertype-instelling voor het algemene schrift (schriftcode "Zyyy") opgehaald.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • fontId

        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 omzet. fontId kan dus verschillen van het lettertype dat aan setFont wordt doorgegeven, bijvoorbeeld als het lettertype niet beschikbaar is op het systeem. Een lege tekenreeks betekent dat er wordt teruggevallen op de globale scriptlettertype-instelling.

      • niveauVanControl

        Niveau van controle

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

Retourneert

  • Promise<object>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getFontList()

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

Geeft een lijst van de lettertypen op het systeem weer.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: FontName[]) => void

Retourneert

  • Promise< FontName []>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getMinimumFontSize()

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

Bepaalt de minimale lettergrootte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.

Retourneert

  • Promise<object>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setDefaultFixedFontSize()

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

Stelt de standaardgrootte in voor lettertypen met een vaste breedte.

Parameters

  • details

    voorwerp

    • pixelSize

      nummer

      De lettergrootte in pixels.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setDefaultFontSize()

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

Stelt de standaard lettergrootte in.

Parameters

  • details

    voorwerp

    • pixelSize

      nummer

      De lettergrootte in pixels.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setFont()

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

Stelt het lettertype in voor een bepaald schrift en een algemene lettertypefamilie.

Parameters

  • details

    voorwerp

    • fontId

      snaar

      De lettertype-ID. Een lege tekenreeks betekent dat er wordt teruggevallen op de algemene scriptlettertype-instelling.

    • generiekeFamilie

      GeneriekeFamilie

      De generieke lettertypefamilie waarvoor het lettertype moet worden ingesteld.

    • script

      ScriptCode optioneel

      De scriptcode die voor het lettertype moet worden gebruikt. Indien deze wordt weggelaten, wordt het lettertype voor het algemene script (scriptcode "Zyyy") gebruikt.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setMinimumFontSize()

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

Stelt de minimale lettergrootte in.

Parameters

  • details

    voorwerp

    • pixelSize

      nummer

      De lettergrootte in pixels.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onDefaultFixedFontSizeChanged

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

Wordt geactiveerd wanneer de standaardinstelling voor de vaste lettergrootte verandert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.

onDefaultFontSizeChanged

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

Wordt geactiveerd wanneer de standaardinstelling voor de lettergrootte verandert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.

onFontChanged

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

Wordt geactiveerd wanneer een lettertype-instelling verandert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • fontId

        snaar

        De lettertype-ID. Zie de beschrijving in getFont .

      • generiekeFamilie

        GeneriekeFamilie

        De generieke lettertypefamilie waarvan de lettertype-instelling is gewijzigd.

      • niveauVanControl

        Niveau van controle

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

      • script

        ScriptCode optioneel

        De scriptcode waarvoor de lettertype-instelling is gewijzigd.

onMinimumFontSizeChanged

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

Wordt geactiveerd wanneer de instelling voor de minimale lettergrootte verandert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        Niveau van controle

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

      • pixelSize

        nummer

        De lettergrootte in pixels.