chrome.fontSettings

Beschreibung

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

Berechtigungen

fontSettings

Manifest

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

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

Allgemeine Schriftarten und -skripte

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 die in der API-Referenz unten aufgeführt sind. 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 auf einer 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 Sprachskripte werden durch ISO 15924-Skriptcode angegeben und in der API aufgelistet weiter unten. 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 gibt die russische Sprache an und verwendet 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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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

Gibt Folgendes zurück:

  • Promise&lt;FontName[]&gt;

    Chrome 96 und höher

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

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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 nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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