chrome.fontSettings

Beschreibung

Mit der chrome.fontSettings API können Sie die Einstellungen für Schriftarten in Chrome verwalten.

Berechtigungen

fontSettings

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

Konzepte und Nutzung

In Chrome können einige Schriftarteinstellungen von bestimmten allgemeinen Schriftfamilien und Sprachskripts abhängen. Beispielsweise kann sich die Schriftart für vereinfachtes Chinesisch ohne Serifen von der Schriftart für Japanisch mit Serifen unterscheiden.

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

Wird für eine Webseite eine Sprache angegeben, wählt Chrome die Schriftart anhand der Einstellung für das entsprechende Sprachskript aus. Wenn keine Sprache angegeben ist, verwendet Chrome die Einstellung für das standardmäßige oder globale Skript.

Die unterstützten Sprachskripts sind durch den Skriptcode nach ISO 15924 angegeben und unter ScriptCode aufgeführt. Technisch gesehen sind Chrome-Einstellungen nicht unbedingt pro Script, sondern hängen auch von der Sprache ab. Chrome wählt beispielsweise die Schriftart für Kyrillisch (ISO 15924-Skriptcode „Cyrl“) aus, wenn eine Webseite die russische Sprache angibt. Diese Schriftart wird nicht nur für kyrillische Schrift, sondern für alle Schriftarten verwendet, z. B. Latein.

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 Sans-Serif-Schriftart für Japanisch festgelegt.

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

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

Typen

FontName

Stellt den Namen einer Schriftart dar.

Attribute

  • displayName

    String

    Der Anzeigename der Schriftart.

  • fontId

    String

    Die Schriftart-ID.

GenericFamily

Eine generische CSS-Schriftfamilie.

Enum

"sansserif"

"serif"

LevelOfControl

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"

"controllable_by_this_extension"

ScriptCode

Ein ISO 15924-Skriptcode. Das Standard- oder globale Skript wird durch den Skriptcode „Zyyy“ dargestellt.

Enum

"Bali"

"Bamu"

"Bass"

"Blis"

"Brah"

"Brai"

"Bugi"

"Cham"

"Cprt"

"Cyrl"

"Cyrs"

"Dsrt"

"Dupl"

"Egyh"

"Geok"

"Glag"

"Gran"

"Hebr"

"Khmr"

"Khoj"

"Kpel"

"Lana"

"Latf"

"Latg"

"Latn"

"Linb"

"Lisu"

"Mand"

"Merc"

"Mlym"

"Mong"

"Nbat"

"Nkgb"

"Osma"

"Samr"

"Saur"

"Sund"

"Syrn"

"Taml"

"Tavt"

"Telu"

"Xpeo"

Methoden

clearDefaultFixedFontSize()

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

Löscht die von dieser Erweiterung festgelegte standardmäßige feste Schriftgröße, falls vorhanden.

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

clearDefaultFontSize()

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

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

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

clearFont()

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

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

Parameters

  • Details

    Objekt

    • genericFamily

      GenericFamily

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

    • Skript

      ScriptCode optional

      Das Skript, für das die Schriftart gelöscht werden soll. Andernfalls wird die Einstellung für die Schriftart im globalen Script gelöscht.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

clearMinimumFontSize()

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

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

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getDefaultFixedFontSize()

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

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

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.

Rückgaben

  • Promise<object>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getDefaultFontSize()

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

Ruft die Standardschriftgröße ab.

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.

Rückgaben

  • Promise<object>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getFont()

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

Ruft die Schriftart für ein bestimmtes Skript und eine allgemeine Schriftartfamilie ab.

Parameters

  • Details

    Objekt

    • genericFamily

      GenericFamily

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

    • Skript

      ScriptCode optional

      Das Skript, für das die Schriftart abgerufen werden soll. Wenn nicht angegeben, wird die Schriftarteinstellung für das globale Skript (Skriptcode „Zyyy“) abgerufen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • fontId

        String

        Die Schriftart-ID. Hierbei kann es sich um die ID der Schriftart handeln, in die das System den Präferenzwert auflöst. Daher kann sich fontId von der an setFont übergebenen Schriftart unterscheiden, beispielsweise wenn die Schriftart im System nicht verfügbar ist. Ein leerer String bedeutet, dass auf die Schriftarteinstellung im globalen Script zurückgegriffen wird.

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

Rückgaben

  • Promise<object>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getFontList()

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

Ruft eine Liste der Schriftarten im System ab.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (results: FontName[])=>void

Rückgaben

  • Promise<FontName[]>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getMinimumFontSize()

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

Ruft die minimale Schriftgröße ab.

Parameters

  • Details

    Objekt optional

    Dieser Parameter wird derzeit nicht verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.

Rückgaben

  • Promise<object>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setDefaultFixedFontSize()

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

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

Parameters

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixel.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setDefaultFontSize()

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

Hier legen Sie die Standardschriftgröße fest.

Parameters

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixel.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setFont()

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

Legt die Schriftart für ein bestimmtes Skript und eine allgemeine Schriftartfamilie fest.

Parameters

  • Details

    Objekt

    • fontId

      String

      Die Schriftart-ID. Ein leerer String bedeutet, dass auf die Schriftarteinstellung im globalen Script zurückgegriffen wird.

    • genericFamily

      GenericFamily

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

    • Skript

      ScriptCode optional

      Der Skriptcode, für den die Schriftart festgelegt werden soll. Wenn nicht angegeben, wird die Schriftarteinstellung für das globale Skript (Skriptcode "Zyyy") festgelegt.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setMinimumFontSize()

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

Legt die Mindestschriftgröße fest.

Parameters

  • Details

    Objekt

    • pixelSize

      Zahl

      Die Schriftgröße in Pixel.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

onDefaultFixedFontSizeChanged

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

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

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.

onDefaultFontSizeChanged

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

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

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.

onFontChanged

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

Wird ausgelöst, wenn sich eine Schriftarteinstellung ändert

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • fontId

        String

        Die Schriftart-ID. Siehe die Beschreibung auf getFont.

      • genericFamily

        GenericFamily

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

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf 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 minimale Schriftgröße ändert

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object)=>void

    • Details

      Objekt

      • levelOfControl

        LevelOfControl

        Das Maß an Kontrolle, das diese Erweiterung auf die Einstellung hat.

      • pixelSize

        Zahl

        Die Schriftgröße in Pixel.