chrome.fontinstellingen

Beschrijving

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

Machtigingen

fontSettings

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

Begrippen en gebruik

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 staan vermeld onder GenericReference . 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 de ISO 15924-scriptcode en vermeld onder ScriptCode . 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()

chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
): 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.

Retourneren

  • Belofte<leegte>

    Chroom 96+

clearDefaultFontSize()

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

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

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

Retourneren

  • Belofte<leegte>

    Chroom 96+

clearFont()

chrome.fontSettings.clearFont(
  details: object,
): 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.

Retourneren

  • Belofte<leegte>

    Chroom 96+

clearMinimumFontSize()

chrome.fontSettings.clearMinimumFontSize(
  details?: object,
): 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.

Retourneren

  • Belofte<leegte>

    Chroom 96+

getDefaultFixedFontSize()

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

Haalt de standaardgrootte op voor lettertypen met vaste breedte.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

Retourneren

  • Belofte<object>

    Chroom 96+

getDefaultFontSize()

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

Geeft de standaardlettergrootte weer.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

Retourneren

  • Belofte<object>

    Chroom 96+

getFont()

chrome.fontSettings.getFont(
  details: object,
): 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.

Retourneren

  • Belofte<object>

    Chroom 96+

getFontList()

chrome.fontSettings.getFontList(): Promise<FontName[]>

Haalt een lijst op met lettertypen op het systeem.

Retourneren

getMinimumFontSize()

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

Geeft de minimale lettergrootte weer.

Parameters

  • details

    object optioneel

    Deze parameter wordt momenteel niet gebruikt.

Retourneren

  • Belofte<object>

    Chroom 96+

setDefaultFixedFontSize()

chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
): Promise<void>

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

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

Retourneren

  • Belofte<leegte>

    Chroom 96+

setDefaultFontSize()

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

Hiermee stelt u de standaardlettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

Retourneren

  • Belofte<leegte>

    Chroom 96+

setFont()

chrome.fontSettings.setFont(
  details: object,
): 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.

Retourneren

  • Belofte<leegte>

    Chroom 96+

setMinimumFontSize()

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

Stelt de minimale lettergrootte in.

Parameters

  • details

    voorwerp

    • pixelgrootte

      nummer

      De lettergrootte in pixels.

Retourneren

  • Belofte<leegte>

    Chroom 96+

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.