chrome.fontSettings

Beschreibung

Verwende die chrome.fontSettings API, um die Einstellungen für Schriftarten in Chrome zu verwalten.

Berechtigungen

fontSettings

Zur Verwendung der Font Settings API müssen Sie die Berechtigung "fontSettings" in der Erweiterung deklarieren. Manifest-Datei. Beispiel:

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

Konzepte und Verwendung

Einige Schriftarteinstellungen in Chrome sind von bestimmten allgemeinen Schriftfamilien und -sprachen abhängig. Skripts erstellt. Beispielsweise kann sich die Schriftart für vereinfachtes Chinesisch ohne Serifen von der Schriftart unterscheiden. für die japanische Schrift mit Serifen verwendet.

Die von Chrome unterstützten generischen Schriftfamilien basieren auf allgemeinen CSS-Schriftfamilien und sind finden Sie unter GenericReference. Wenn auf einer Webseite eine allgemeine Schriftfamilie angegeben ist, wählt Chrome die Schriftart an die jeweilige Einstellung anpassen. Wenn keine generische Schriftfamilie angegeben ist, verwendet Chrome die für die Einstellung „Standard“ generische Schriftfamilie.

Wenn für eine Webseite eine Sprache angegeben ist, wählt Chrome die Schriftart anhand der Einstellung für die in der entsprechenden Sprache. Wenn keine Sprache festgelegt ist, verwendet Chrome die Standardeinstellung, oder global, script.

Die unterstützten Sprachskripts werden durch den ISO 15924-Skriptcode angegeben und unter ScriptCode Technisch gesehen sind die Chrome-Einstellungen nicht streng per Skript festgelegt, sondern hängen von Sprache. So wählt Chrome beispielsweise die Schriftart für Kyrillisch (ISO 15924-Skriptcode "Cyrl") aus, wenn ein wird die russische Sprache angegeben und diese Schriftart nicht nur für die kyrillische Schrift, sondern auch für in der Schriftart enthalten ist, 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 serifenlose Schrift für Japanisch festgelegt.

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

Um diese API auszuprobieren, installieren Sie das fontSettings API-Beispiel aus chrome-extension-samples. zu erstellen.

Typen

FontName

Der Name einer Schriftart.

Attribute

• displayName

  String

  Der Anzeigename der Schriftart.

• fontId

  String

  Die Schriftart-ID.

GenericFamily

Eine generische CSS-Schriftfamilie.

Enum

"Standard"

„sansserif“

„serif“

„Behoben“

"kursiv"

"Fantasy"

"math"

LevelOfControl

Eine von not\_controllable: kann von keiner Erweiterung gesteuert werden controlled\_by\_other\_extensions: von Erweiterungen mit höherer Priorität gesteuert controllable\_by\_this\_extension: kann von dieser Erweiterung gesteuert werden controlled\_by\_this\_extension: von dieser Erweiterung gesteuert

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Ein ISO 15924-Skriptcode. Das standardmäßige oder globale 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"

„Dosen“

„Sarah“

"Cham"

„Cher“

„Zirkel“

„Copt“

"Cprt"

"Cyrl"

"Cyrs"

„Deva“

„DSRT“

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

„Äthi“

"Geor"

„Geok“

"Glag"

„Goth“

"Gran"

"Grek"

„Gujr“

„Guru“

"Hängen"

"Hani"

„Hano“

"Hans"

"Hant"

„Hebr“

"Hluw"

"Hmng"

"Hung"

„Inds“

„Italienisch“

„Java“

"Jpan"

„Jurc“

„Kali“

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

„Kthi“

„Lana“

„Laoo“

"Latf"

"Latg"

"Latn"

"Lepc"

"Glied"

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

„Palme“

"Dauer"

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

„Thailändisch“

„Tibt“

„Tirh“

„Ugar“

„Vaii“

„Visp“

„Wara“

"Wole"

„Xpeo“

"Xsux"

„Yiii“

„Zmth“

„Zsym“

„Zyyy“

Methoden

clearDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

clearDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

clearFont()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• 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. Ohne Angabe wird die globale Skriptschrifteinstellung gelöscht.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

clearMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Löscht die von dieser Erweiterung festgelegte minimale Schriftgröße (falls vorhanden).

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

Gibt Folgendes zurück:

• Promise&lt;object&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Ruft die Standardschriftgröße ab.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

Gibt Folgendes zurück:

• Promise&lt;object&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getFont()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Ruft die Schriftart für ein bestimmtes Skript und eine allgemeine 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 nichts angegeben ist, wird die Schriftarteinstellung für das globale Skript (Skriptcode "Zyyy") abgerufen.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • fontId

      String

      Die Schriftart-ID. Dies kann nicht der tatsächliche Wert der Schriftart-ID sein, sondern die ID der Schriftart, in die das System den Einstellungswert auflöst. fontId kann sich also von der an setFont übergebenen Schriftart unterscheiden, wenn die Schriftart beispielsweise im System nicht verfügbar ist. Ein leerer String bedeutet, dass die globale Skriptschriftart als Fallback ausgewählt wird.

    • levelOfControl

      LevelOfControl

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

Gibt Folgendes zurück:

• Promise&lt;object&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getFontList()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Ruft eine Liste der Schriftarten im System ab.

Parameter

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (results: FontName[]) => void

  • Ergebnisse

    FontName[]

Gibt Folgendes zurück:

• Promise&lt;FontName[]&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Ruft die minimale Schriftgröße ab.

Parameter

• Details

  Objekt optional

  Dieser Parameter wird derzeit nicht verwendet.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.

Gibt Folgendes zurück:

• Promise&lt;object&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Hiermit wird die Standardschriftgröße festgelegt.

Parameter

• Details

  Objekt

  • pixelSize

    Zahl

    Die Schriftgröße in Pixeln.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setFont()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• Details

  Objekt

  • fontId

    String

    Die Schriftart-ID. Ein leerer String bedeutet, dass auf die globale Schrifteinstellung des Skripts 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 keine Angabe gemacht wird, wird die Schriftarteinstellung für das globale Skript (Skriptcode "Zyyy") festgelegt.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback ü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: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

      Die Kontrollebene, 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: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

      Die Kontrollebene, 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: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • fontId

      String

      Die Schriftart-ID. Weitere Informationen finden Sie in der Beschreibung zu getFont.

    • genericFamily

      GenericFamily

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

    • levelOfControl

      LevelOfControl

      Die Kontrollebene, 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: <ph type="x-smartling-placeholder"></ph>

  (details: object) => void

  • Details

    Objekt

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      Zahl

      Die Schriftgröße in Pixeln.