chrome.fontinstellingen

Beschrijving

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

Machtigingen

fontSettings

Als u de Fontinstellingen-API wilt gebruiken, moet u de machtiging "fontSettings" opgeven in het extensiemanifest . Bijvoorbeeld:

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

Concepten en gebruik

Chrome staat toe dat sommige lettertype-instellingen afhankelijk zijn van bepaalde generieke lettertypefamilies en taalscripts. Het lettertype dat wordt gebruikt voor schreefloos Vereenvoudigd Chinees kan bijvoorbeeld verschillen van het lettertype dat wordt gebruikt voor Japans schreefletters.

De generieke lettertypefamilies die door Chrome worden ondersteund, zijn gebaseerd op generieke CSS-lettertypefamilies en worden vermeld onder GenericReference . Wanneer een webpagina een generieke lettertypefamilie specificeert, selecteert Chrome het lettertype op basis van de overeenkomstige instelling. Als er geen generieke lettertypefamilie is opgegeven, 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 overeenkomstige taalscript. Als er geen taal is opgegeven, gebruikt Chrome de instelling voor het standaard- of globale script.

De ondersteunde taalscripts worden gespecificeerd door ISO 15924-scriptcode en vermeld onder ScriptCode . Technisch gezien zijn de Chrome-instellingen 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 het Cyrillische schrift, maar voor alles wat het lettertype omvat, zoals Latijn.

Voorbeelden

De volgende code krijgt het standaardlettertype voor Arabisch.

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 te proberen, installeert u het fontSettings API-voorbeeld uit de chrome-extension-samples- repository.

Soorten

FontName

Vertegenwoordigt een lettertypenaam.

Eigenschappen

  • weergavenaam

    snaar

    De weergavenaam van het lettertype.

  • lettertypeId

    snaar

    De lettertype-ID.

GenericFamily

Een generieke CSS-lettertypefamilie.

Enum

"standaard"

"zonder schreef"

"serif"

"vast"

"cursief"

"fantasie"

"wiskunde"

LevelOfControl

Eén van not\_controllable : kan door geen enkele extensie worden controlled\_by\_other\_extensions : beheerd door extensies met hogere prioriteit controllable\_by\_this\_extension : kan worden bestuurd door deze extensie controlled\_by\_this\_extension : bestuurd door deze uitbreiding

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"

"Arm"

"Avst"

"Bali"

"Bamu"

"Bas"

"Bat"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Blikjes"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Griek"

"Gujr"

"Goeroe"

"Hangen"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Opgehangen"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Laat"

"Latijn"

"Lepc"

"Ledemaat"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Herstellen"

"Merc"

"Mero"

"Mlym"

"Maan"

"Mong"

"Mroo"

"Mtei"

"Mijnheer"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olk"

"Orkh"

"Orya"

"Osma"

"Palm"

"Permanent"

"Pag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Run"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgw"

"Shaw"

"Scherp"

"Zonde"

"Sinh"

"Sora"

"Zon"

"Sylo"

"Syrc"

"Syr"

"Syrj"

"Syrn"

"Tag"

"Takr"

"Verhaal"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thais"

"Tibt"

"Tirh"

"Oegar"

"Vai"

"Visp"

"Wara"

"Wol"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Methoden

clearDefaultFixedFontSize()

Belofte
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

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

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

clearDefaultFontSize()

Belofte
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

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

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

clearFont()

Belofte
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

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

Parameters

  • details

    voorwerp

    • generiekFamilie

      Generieke Familie

      De generieke lettertypefamilie waarvoor het lettertype moet worden gewist.

    • script

      Scriptcode optioneel

      Het script waarvoor het lettertype moet worden gewist. Als u dit weglaat, wordt de instelling voor het globale scriptlettertype gewist.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

clearMinimumFontSize()

Belofte
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

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

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getDefaultFixedFontSize()

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

Krijgt de standaardgrootte voor lettertypen met een vaste breedte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retouren

  • Beloof<object>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getDefaultFontSize()

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

Krijgt de standaardlettergrootte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retouren

  • Beloof<object>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getFont()

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

Haalt het lettertype op voor een bepaald script en een generieke lettertypefamilie.

Parameters

  • details

    voorwerp

    • generiekFamilie

      Generieke Familie

      De generieke lettertypefamilie waarvoor het lettertype moet worden opgehaald.

    • script

      Scriptcode optioneel

      Het script waarvoor het lettertype moet worden opgehaald. Als u dit weglaat, wordt de lettertype-instelling voor het globale script (scriptcode "Zyyy") opgehaald.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • lettertypeId

        snaar

        De lettertype-ID. In plaats van de letterlijke lettertype-ID-voorkeurswaarde 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. De lege tekenreeks duidt op een terugval op de globale scriptlettertype-instelling.

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

Retouren

  • Beloof<object>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getFontList()

Belofte
chrome.fontSettings.getFontList(
  callback?: function,
)

Krijgt een lijst met lettertypen op het systeem.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: FontName[]) => void

Retouren

  • Beloof < Lettertypenaam []>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getMinimumFontSize()

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

Krijgt de minimale lettergrootte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.

Retouren

  • Beloof<object>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setDefaultFixedFontSize()

Belofte
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

Stelt de standaardgrootte in voor lettertypen met een vaste breedte.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setDefaultFontSize()

Belofte
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

Stelt de standaardlettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setFont()

Belofte
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

Stelt het lettertype in voor een bepaald script en een generieke lettertypefamilie.

Parameters

  • details

    voorwerp

    • lettertypeId

      snaar

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

    • generiekFamilie

      Generieke Familie

      De generieke lettertypefamilie waarvoor het lettertype moet worden ingesteld.

    • script

      Scriptcode optioneel

      De scriptcode waarmee het lettertype moet worden ingesteld. Als u dit weglaat, wordt de lettertype-instelling voor het globale script (scriptcode "Zyyy") ingesteld.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

setMinimumFontSize()

Belofte
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

Stelt de minimale lettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onDefaultFixedFontSizeChanged

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

Wordt geactiveerd wanneer de standaardinstelling voor de vaste lettergrootte verandert.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat 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 parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat 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 parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • lettertypeId

        snaar

        De lettertype-ID. Zie de beschrijving in getFont .

      • generiekFamilie

        Generieke Familie

        De generieke lettertypefamilie waarvoor de lettertype-instelling is gewijzigd.

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

      • 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

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • niveauVanControl

        NiveauVanControl

        Het controleniveau dat deze extensie heeft over de instelling.

      • pixelgrootte

        nummer

        De lettergrootte in pixels.