chrome.fontSettings

Beschreibung

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

Berechtigungen

fontSettings

Manifest

Wenn Sie die Font Settings API verwenden möchten, müssen Sie die Berechtigung „fontSettings“ im Erweiterungsmanifest deklarieren. Beispiel:

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

Allgemeine Schriftfamilien und Skripts

In Chrome können einige Schriftarteinstellungen von bestimmten generischen Schriftfamilien und Sprachscripts abhängen. So kann sich beispielsweise die für serifenlose vereinfachte chinesische Schrift verwendete Schriftart von der für japanische Serifenschrift verwendete Schriftart unterscheiden.

Die von Chrome unterstützten generischen Schriftfamilien basieren auf generischen CSS-Schriftfamilien und sind in der API-Referenz unten 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 das entsprechende Sprachskript aus. Wenn keine Sprache angegeben ist, verwendet Chrome die Einstellung für das Standardskript oder das globale Skript.

Die unterstützten Sprachskripts werden durch den ISO 15924-Skriptcode angegeben und sind unten in der API-Referenz aufgeführt. Technisch gesehen sind die Chrome-Einstellungen nicht nur skriptabhängig, sondern auch sprachabhängig. Wenn auf einer Webseite beispielsweise die russische Sprache angegeben ist, wählt Chrome die Schriftart für das kyrillische Alphabet (ISO 15924-Schriftartcode „Cyrl“) aus. Diese Schriftart wird dann nicht nur für das kyrillische Alphabet, sondern für alle Zeichen verwendet, die von der Schriftart abgedeckt werden, z. B. für das lateinische Alphabet.

Beispiele

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

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

Im nächsten Snippet wird die serifenlose Schriftart für Japanisch festgelegt.

chrome.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 allgemeine CSS-Schriftfamilie.

Enum

„standard“

"sansserif"

"serif"

„fixed“

"cursive"

"fantasy"

"math"

LevelOfControl

Einer der folgenden Werte: not\_controllable: kann nicht von einer 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 Standardskript (globales Skript) wird durch den Skriptcode „Zyyy“ dargestellt.

Enum

„Afak“

„Arabisch“

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

„Gliedmaße“

„Lina“

"Linb"

„Lisu“

„Loma“

„Lyci“

„Lydi“

„Mand“

„Mani“

„Maya“

„Mend“

„Merc“

„Mero“

"Mlym"

„Mond“

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

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

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

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

clearDefaultFontSize()

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

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

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

clearFont()

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

Löscht die von dieser Erweiterung festgelegte Schriftart, sofern 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. Wird sie nicht angegeben, wird die globale Einstellung für die Schriftart des Skripts gelöscht.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

clearMinimumFontSize()

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

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

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDefaultFixedFontSize()

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

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

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        Zahl

        Die Schriftgröße in Pixeln.

Ausgabe

  • Promise<object>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDefaultFontSize()

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

Ruft die Standardschriftgröße ab.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        Zahl

        Die Schriftgröße in Pixeln.

Ausgabe

  • Promise<object>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getFont()

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

Ruft die Schriftart für ein bestimmtes Schriftsystem 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. Wird sie weggelassen, wird die Schriftarteinstellung für das globale Script (Scriptcode „Zyyy“) abgerufen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • fontId

        String

        Die Schriftart-ID. Anstelle des Literalwerts der Schriftart-ID kann dies die ID der Schriftart sein, in die der Wert aufgelöst wird. fontId kann sich also von der an setFont übergebenen Schriftart unterscheiden, wenn die Schriftart beispielsweise nicht auf dem System verfügbar ist. Der leere String bedeutet, dass auf die globale Einstellung für die Schriftart des Scripts zurückgegriffen wird.

      • levelOfControl

        LevelOfControl

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

Ausgabe

  • Promise<object>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getFontList()

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

Ruft eine Liste der Schriftarten auf dem System ab.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (results: FontName[]) => void

Ausgabe

  • Promise<FontName[]>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getMinimumFontSize()

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

Gibt die Mindestschriftgröße zurück.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        Zahl

        Die Schriftgröße in Pixeln.

Ausgabe

  • Promise<object>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setDefaultFixedFontSize()

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

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

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setDefaultFontSize()

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

Legt die Standardschriftgröße fest.

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setFont()

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

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

Parameter

  • Details

    Objekt

    • fontId

      String

      Die Schriftart-ID. Ein leerer String bedeutet, dass die globale Einstellung für die Schriftart des Scripts verwendet 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. Wird nichts angegeben, wird die Schriftart für das globale Skript (Skriptcode „Zyyy“) festgelegt.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setMinimumFontSize()

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

Legt die minimale Schriftgröße fest.

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 Kontrollstufe, 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 Standardeinstellung für die Schriftgröße ändert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Die Kontrollstufe, 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 Schriftart geändert wurde.

      • levelOfControl

        LevelOfControl

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

      • Skript

        ScriptCode optional

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

onMinimumFontSizeChanged

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        Zahl

        Die Schriftgröße in Pixeln.