browser.fontSettings

Beschreibung

Verwenden Sie die chrome.fontSettings API, um die Schriftarteinstellungen von Chrome zu verwalten.

Berechtigungen

fontSettings

Wenn Sie die Font Settings API verwenden möchten, müssen Sie die Berechtigung "fontSettings" im Manifest der Erweiterung deklarieren. Beispiel:

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

Konzepte und Verwendung

In Chrome können einige Schrifteinstellungen von bestimmten generischen Schriftfamilien und Sprachskripten abhängen. Beispielsweise kann sich die Schriftart für serifenloses vereinfachtes Chinesisch von der Schriftart für Japanisch mit Serifen unterscheiden.

Die von Chrome unterstützten generischen Schriftfamilien basieren auf generischen CSS-Schriftfamilien und sind unter GenericReference aufgeführt. Wenn auf einer Webseite eine generische Schriftfamilie angegeben ist, wählt Chrome die Schriftart anhand der entsprechenden Einstellung aus. Wenn keine generische Schriftfamilie angegeben ist, verwendet Chrome die Einstellung für die generische Schriftfamilie „Standard“.

Wenn auf einer Webseite eine Sprache angegeben ist, wählt Chrome die Schriftart basierend auf der Einstellung für die entsprechende Sprachschrift aus. Wenn keine Sprache angegeben ist, verwendet Chrome die Einstellung für das Standardskript oder das globale Skript.

Die unterstützten Schriftsysteme werden durch den ISO 15924-Schriftcode angegeben und sind unter ScriptCode aufgeführt. Technisch gesehen sind die Chrome-Einstellungen nicht strikt pro Schrift, sondern hängen auch von der Sprache ab. Chrome wählt beispielsweise die Schriftart für Kyrillisch (ISO 15924-Schriftcode „Cyrl“) aus, wenn auf einer Webseite die russische Sprache angegeben ist. Diese Schriftart wird dann nicht nur für kyrillische Schrift, sondern für alles verwendet, was die Schriftart abdeckt, z. B. Latein.

Beispiele

Mit dem folgenden Code wird die Standardschriftart für Arabisch abgerufen.

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

Im nächsten Snippet wird die Sans-Serif-Schriftart für Japanisch festgelegt.

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

Wenn Sie diese API ausprobieren möchten, installieren Sie das fontSettings API-Beispiel aus dem Repository chrome-extension-samples.

Typen

FontName

Stellt einen Schriftartnamen dar.

Attribute

• displayName

  String

  Der Anzeigename der Schriftart.

• fontId

  String

  Die Schriftart-ID.

GenericFamily

Eine generische CSS-Schriftfamilie.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"fantasy"

"math"

LevelOfControl

Einer der folgenden Werte: not\_controllable: Kann von keiner Erweiterung gesteuert werden controlled\_by\_other\_extensions: Wird von Erweiterungen mit höherer Priorität gesteuert controllable\_by\_this\_extension: Kann von dieser Erweiterung gesteuert werden controlled\_by\_this\_extension: Wird von dieser Erweiterung gesteuert

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Ein ISO 15924-Schriftcode. Das Standard- oder globale Script wird durch den Scriptcode „Zyyy“ dargestellt.

Enum

"Afak"

"Arab"

„Aran“

„Armi“

"Armn"

"Avst"

"Bali"

"Bamu"

Bass

"Batk"

"Beng"

Blis

"Bopo"

„Brah“

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Cans"

„Cari“

Cham

Cher

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

„Dupl“

"Egyd"

"Egyh"

"Egyp"

„Elba“

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

Guru

„Hang“

"Hani"

"Hano"

„Hans“

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Inds"

"Ital"

"Java"

"Jpan"

Jurc

"Kali"

"Khar"

"Khmr"

„Khoj“

"Knda"

"Kpel"

"Kthi"

„Lana“

„Laoo“

"Latf"

"Latg"

"Latn"

"Lepc"

"Limb"

"Lina"

"Linb"

"Lisu"

"Loma"

„Lyci“

"Lydi"

"Mand"

„Mani“

„Maya“

Mend

"Merc"

"Mero"

"Mlym"

Moon

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

„Palm“

„Perm“

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

Runr

"Samr"

„Sara“

Sarb

"Saur"

"Sgnw"

"Shaw"

"Shrd"

Sind

"Sinh"

Sora

"Sund"

„Sylo“

"Syrc"

Syre

"Syrj"

"Syrn"

"Tagb"

Takr

„Tale“

„Talu“

"Taml"

Tang

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thai"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

„Wara“

"Wole"

"Xpeo"

"Xsux"

„Yiii“

"Zmth"

"Zsym"

"Zyyy"

Methoden

clearDefaultFixedFontSize()

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

Löscht die von dieser Erweiterung festgelegte Standard-Schriftgröße, falls vorhanden.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

clearDefaultFontSize()

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

Löscht die von dieser Erweiterung festgelegte Standardschriftgröße, falls vorhanden.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

clearFont()

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

Löscht die von dieser Erweiterung festgelegte Schriftart, falls vorhanden.

Parameter

• Details

  Objekt

  • genericFamily

    GenericFamily

    Die generische Schriftfamilie, für die die Schriftart gelöscht werden soll.

  • Skript

    ScriptCode optional

    Das Skript, für das die Schriftart gelöscht werden soll. Wenn Sie diese Angabe weglassen, wird die globale Einstellung für die Schriftart des Skripts gelöscht.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

clearMinimumFontSize()

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

Löscht die von dieser Erweiterung festgelegte Mindestschriftgröße, falls vorhanden.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

getDefaultFixedFontSize()

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

Ruft die Standardgröße für Schriftarten mit fester Breite ab.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<object>

  Chrome 96 oder höher

getDefaultFontSize()

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

Ruft die Standardschriftgröße ab.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<object>

  Chrome 96 oder höher

getFont()

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

Ruft die Schriftart für ein bestimmtes Skript und eine generische Schriftfamilie ab.

Parameter

• Details

  Objekt

  • genericFamily

    GenericFamily

    Die generische Schriftfamilie, für die die Schriftart abgerufen werden soll.

  • Skript

    ScriptCode optional

    Das Skript, für das die Schriftart abgerufen werden soll. Wenn Sie diesen Parameter weglassen, wird die Schriftarteinstellung für das globale Skript (Skriptcode „Zyyy“) abgerufen.

Ausgabe

• Promise<object>

  Chrome 96 oder höher

getFontList()

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

Ruft eine Liste der Schriftarten auf dem System ab.

Ausgabe

• Promise<FontName[]>

  Chrome 96 oder höher

getMinimumFontSize()

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

Ruft die minimale Schriftgröße ab.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

Ausgabe

• Promise<object>

  Chrome 96 oder höher

setDefaultFixedFontSize()

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

Legt die Standardgröße für Schriftarten mit fester Breite fest.

Parameter

• Details

  Objekt

  • pixelSize

    Zahl

    Die Schriftgröße in Pixeln.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

setDefaultFontSize()

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

Legt die Standardschriftgröße fest.

Parameter

• Details

  Objekt

  • pixelSize

    Zahl

    Die Schriftgröße in Pixeln.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

setFont()

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

Legt die Schriftart für ein bestimmtes Skript und eine generische Schriftfamilie fest.

Parameter

• Details

  Objekt

  • fontId

    String

    Die Schriftart-ID. Der leere String bedeutet, dass auf die globale Einstellung für die Schriftart des Skripts zurückgegriffen wird.

  • genericFamily

    GenericFamily

    Die generische Schriftfamilie, für die die Schriftart festgelegt werden soll.

  • Skript

    ScriptCode optional

    Der Skriptcode, für den die Schriftart festgelegt werden soll. Wenn keine Angabe erfolgt, wird die Schriftarteinstellung für das globale Skript (Skriptcode „Zyyy“) festgelegt.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

setMinimumFontSize()

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

Legt die Mindestschriftgröße fest.

Parameter

• Details

  Objekt

  • pixelSize

    Zahl

    Die Schriftgröße in Pixeln.

Ausgabe

• Promise<void>

  Chrome 96 oder höher

Ereignisse

onDefaultFixedFontSizeChanged

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

Wird ausgelöst, wenn sich die Standardeinstellung für die feste Schriftgröße ändert.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

      Die Kontrolle, die diese Erweiterung über die Einstellung hat.

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

onDefaultFontSizeChanged

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

Wird ausgelöst, wenn sich die Einstellung für die Standardschriftgröße ändert.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

      Die Kontrolle, die diese Erweiterung über die Einstellung hat.

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

onFontChanged

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

Wird ausgelöst, wenn sich eine Schriftarteinstellung ändert.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (details: object) => void

  • Details

    Objekt

    • fontId

      String

      Die Schriftart-ID. Siehe Beschreibung in getFont.

    • genericFamily

      GenericFamily

      Die generische Schriftfamilie, für die die Schriftarteinstellung geändert wurde.

    • levelOfControl

      LevelOfControl

      Die Kontrolle, die diese Erweiterung über die Einstellung hat.

    • Skript

      ScriptCode optional

      Der Skriptcode, für den die Schriftarteinstellung geändert wurde.

onMinimumFontSizeChanged

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

Wird ausgelöst, wenn sich die Einstellung für die Mindestschriftgröße ändert.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

      Die Kontrolle, die diese Erweiterung über die Einstellung hat.

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.