chrome.fontSettings

Beschreibung

Mit der chrome.fontSettings API können Sie die Schrifteinstellungen von Chrome verwalten.

Berechtigungen

fontSettings

Wenn Sie die Font Settings API verwenden möchten, müssen Sie die Berechtigung "fontSettings" im Manifest der Erweiterung angeben. 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 Sprachschriften abhängen. Die Schriftart für vereinfachtes Chinesisch ohne Serifen kann sich beispielsweise 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 Schrift basierend auf 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 Standard- oder globale Script.

Die unterstützten Schriftsysteme werden durch den ISO 15924-Schriftcode angegeben und unter ScriptCode aufgeführt. Technisch gesehen sind die Chrome-Einstellungen nicht streng nach Script, sondern auch nach Sprache festgelegt. Wenn auf einer Webseite die russische Sprache angegeben ist, wählt Chrome beispielsweise die Schriftart für Kyrillisch (ISO 15924-Schriftcode „Cyrl“) aus und verwendet diese Schriftart nicht nur für Kyrillisch, sondern für alle Sprachen, die die Schriftart abdeckt, z. B. Lateinisch.

Beispiele

Im 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 API-Beispiel für die fontSettings API aus dem Repository chrome-extension-samples.

Typen

FontName

Stellt einen Schriftartennamen dar.

Attribute

  • displayName

    String

    Der Anzeigename der Schriftart.

  • fontId

    String

    Die Schrift-ID.

GenericFamily

Eine allgemeine CSS-Schriftfamilie.

Enum

„standard“

„sansserif“

„serif“

„fixed“

„Kursiv“

"fantasy"

"math"

LevelOfControl

Eine der folgenden Optionen: 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-Schriftsystemcode. Das Standard- oder globale Schriftsystem wird durch den Schriftcode „Zyyy“ dargestellt.

Enum

„Afak“

„Arabisch“

„Armi“

„Armn“

„Avst“

„Bali“

„Bamu“

„Bass“

„Batk“

„Beng“

„Blis“

„Bopo“

„Brah“

„Brai“

„Bugi“

„Buhd“

„Cakm“

„Dosen“

„Cari“

„Cham“

„Liebe“

„Cirt“

„Copt“

„Cprt“

„Cyrl“

„Cyrs“

„Deva“

„Dsrt“

„Dupl“

„Egyd“

„Egyh“

„Egyp“

„Elba“

„Ethi“

„Geor“

„Geok“

„Glag“

„Goth“

„Gran“

„Grek“

„Gujr“

„Guru“

„Hängen“

„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“

„Reparieren“

„Merc“

„Mero“

„Mlym“

„Mond“

"Mong"

„Mroo“

„Mtei“

„Mymr“

„Narb“

„Nbat“

„Nkgb“

„Nkoo“

„Nshu“

„Ogam“

„Olck“

„Orkh“

„Orya“

„Osma“

„Palme“

„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“

„Märchen“

„Talu“

„Taml“

„Tang“

„Tavt“

„Telu“

„Teng“

„Tfng“

„Tglg“

„Thaa“

„Thai“

„Tibet“

„Tirh“

„Ugar“

„Vaii“

„Visp“

„Wara“

„Wole“

„Xpeo“

„Xsux“

„Yiii“

„Zmth“

„Zsym“

„Zyyy“

Methoden

clearDefaultFixedFontSize()

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

Die Standardschriftgröße, die von dieser Erweiterung festgelegt wurde, wird gelöscht, falls vorhanden.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

clearDefaultFontSize()

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

Die Standardschriftgröße, die von dieser Erweiterung festgelegt wurde, wird gelöscht.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

clearFont()

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

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 Script, für das die Schriftart gelöscht werden soll. Wird diese Option nicht angegeben, wird die globale Schriftarteinstellung für Scripts gelöscht.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

clearMinimumFontSize()

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

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

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getDefaultFixedFontSize()

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

Die Standardgröße für Schriftarten mit fester Breite.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function 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.

Gibt Folgendes zurück:

  • Promise<object>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getDefaultFontSize()

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

Die Standardschriftgröße wird abgerufen.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function 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.

Gibt Folgendes zurück:

  • Promise<object>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getFont()

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

Ruft die Schrift für ein bestimmtes Schriftbild 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 Script, für das die Schriftart abgerufen werden soll. Wird dieser Parameter weggelassen, wird die Schriftarteinstellung für das globale Schriftsystem (Schriftcode „Zyyy“) abgerufen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • fontId

        String

        Die Schrift-ID. Anstatt des Werts für die Schriftart-ID kann dies die ID der Schriftart sein, auf die das System den Einstellungswert umwandelt. fontId kann sich also von der Schriftart unterscheiden, die an setFont übergeben wird, wenn die Schriftart beispielsweise nicht auf dem System verfügbar ist. Der leere String steht für den Rückfall auf die globale Schriftarteinstellung für Scripts.

      • levelOfControl

        LevelOfControl

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

Gibt Folgendes zurück:

  • Promise<object>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getFontList()

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

Ruft eine Liste der Schriftarten auf dem System ab.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (results: FontName[]) => void

Gibt Folgendes zurück:

  • Promise<FontName[]>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getMinimumFontSize()

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

Die minimale Schriftgröße wird abgerufen.

Parameter

  • Details

    object optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    function 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.

Gibt Folgendes zurück:

  • Promise<object>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

setDefaultFixedFontSize()

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

Hiermit wird die Standardgröße für Schriftarten mit fester Breite festgelegt.

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

setDefaultFontSize()

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

Hiermit wird die Standardschriftgröße festgelegt.

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

setFont()

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

Hiermit wird die Schrift für ein bestimmtes Schriftbild und eine generische Schriftfamilie festgelegt.

Parameter

  • Details

    Objekt

    • fontId

      String

      Die Schrift-ID. Ein leerer String bedeutet, dass auf die globale Schriftarteinstellung für Scripts zurückgegriffen wird.

    • genericFamily

      GenericFamily

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

    • Skript

      ScriptCode optional

      Der Scriptcode, für den die Schriftart festgelegt werden soll. Wird dieser Parameter weggelassen, wird die Schriftarteinstellung für das globale Schriftsystem (Schriftcode „Zyyy“) festgelegt.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

setMinimumFontSize()

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

Legt die Mindestschriftgröße fest.

Parameter

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 96 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können beide nicht für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

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 Schrift-ID. Siehe Beschreibung unter getFont.

      • genericFamily

        GenericFamily

        Die generische Schriftfamilie, für die sich die Schrifteinstellung geändert hat.

      • levelOfControl

        LevelOfControl

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

      • Skript

        ScriptCode optional

        Der Scriptcode, 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.