chrome.fontSettings

Description

Utilisez l'API chrome.fontSettings pour gérer les paramètres des polices dans Chrome.

Autorisations

fontSettings

Pour utiliser l'API Font Settings, vous devez déclarer l'autorisation "fontSettings" dans l'extension le fichier manifeste. Exemple :

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

Concepts et utilisation

Certains paramètres de police de Chrome dépendent de certaines familles de polices et langues génériques. les scripts. Par exemple, la police utilisée pour le chinois simplifié sans Serif peut être différente de celle utilisée pour le chinois simplifié utilisé pour le japonais Serif.

Les familles de polices génériques compatibles avec Chrome sont basées sur des familles de polices génériques CSS et sont sous GenericReference. Lorsqu'une page Web spécifie une famille de polices générique, Chrome sélectionne la police en fonction du paramètre correspondant. Si aucune famille de polices générique n'est spécifiée, Chrome utilise la le paramètre "standard" famille de polices générique.

Lorsqu'une page Web spécifie une langue, Chrome sélectionne la police en fonction du paramètre de la script de langage correspondant. Si aucune langue n'est spécifiée, Chrome utilise le paramètre de la langue par défaut, ou global, script.

Les scripts de langage pris en charge sont spécifiés par le code de script ISO 15924 et répertoriés sous ScriptCode Techniquement, les paramètres de Chrome ne sont pas strictement définis par script, mais dépendent également de langue. Par exemple, Chrome choisit la police pour l'alphabet cyrillique (code de script ISO 15924 "Cyrl") lorsqu'un page Web spécifie la langue russe et utilise cette police non seulement pour les caractères cyrilliques, mais aussi pour tout ce que la police couvre, comme le latin.

Exemples

Le code suivant permet d'obtenir la police standard pour l'arabe.

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

L'extrait de code suivant définit la police sans-serif pour le japonais.

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

Pour essayer cette API, installez l'exemple d'API fontSettings à partir de chrome-extension-samples. un dépôt de clés.

Types

FontName

Représente un nom de police.

Propriétés

  • displayName

    chaîne

    Nom à afficher pour la police.

  • fontId

    chaîne

    ID de la police.

GenericFamily

Famille de polices CSS générique.

Énumération

"standard"

"sansserif"

"Serif"

"fixe"

"cursif"

"fantasy"

"maths"

LevelOfControl

L'une des valeurs suivantes : not\_controllable: ne peut être contrôlé par aucune extension. controlled\_by\_other\_extensions: contrôlé par des extensions ayant une priorité plus élevée controllable\_by\_this\_extension: peut être contrôlé par cette extension. controlled\_by\_this\_extension: contrôlé par cette extension

Énumération

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Code de script ISO 15924. Le script par défaut, ou global, est représenté par le code de script "Zyyy".

Énumération

"Afak"

"Arabe"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Basse"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Boîtes de conserve"

"Cari"

"Camille"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Grand"

"Grek"

"Gujr"

"Expert"

"Raccrocher"

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

"Corriger"

"Merc"

"Mero"

"Mlym"

"Lune"

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

"Dim"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Conte"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

Tfng

"Tglg"

"Thaa"

"Thaïlandais"

"Tibt"

"Tir"

"Ugar"

"Vaii"

"Visp"

"Garantie"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Méthodes

clearDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Efface la taille de police fixe par défaut définie par cette extension, le cas échéant.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

clearDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

Efface la taille de police par défaut définie par cette extension, le cas échéant.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

clearFont()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

Efface la police définie par cette extension, le cas échéant.

Paramètres

  • détails

    objet

    • genericFamily

      GenericFamily

      Famille de polices génériques pour laquelle la police doit être effacée

    • écriture

      ScriptCode facultatif

      Script pour lequel la police doit être effacée. Si cette valeur est omise, le paramètre de police du script global est effacé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

clearMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

Permet d'effacer la taille de police minimale définie par cette extension, le cas échéant.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Récupère la taille par défaut des polices à largeur fixe.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.

Renvoie

  • Promise&lt;object&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

Récupère la taille de police par défaut.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.

Renvoie

  • Promise&lt;object&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getFont()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
)

Récupère la police d'un script donné et d'une famille de polices générique.

Paramètres

  • détails

    objet

    • genericFamily

      GenericFamily

      Famille de polices génériques pour laquelle la police doit être récupérée.

    • écriture

      ScriptCode facultatif

      Script pour lequel la police doit être récupérée. En cas d'omission, le paramètre de police du script global (code de script "Zyyy") est récupéré.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • fontId

        chaîne

        ID de la police. Plutôt que d'indiquer la valeur de préférence d'ID de police littérale, il peut s'agir de l'ID de la police vers laquelle le système résout la valeur de préférence. Ainsi, fontId peut être différent de la police transmise à setFont si, par exemple, elle n'est pas disponible sur le système. Une chaîne vide correspond au paramètre de police global du script.

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

Renvoie

  • Promise&lt;object&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getFontList()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.getFontList(
  callback?: function,
)

Récupère une liste des polices présentes sur le système.

Paramètres

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (results: FontName[]) => void

Renvoie

  • Promise&lt;FontName[]&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

getMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

Récupère la taille de police minimale.

Paramètres

  • détails

    objet facultatif

    Ce paramètre n'est actuellement pas utilisé.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.

Renvoie

  • Promise&lt;object&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

setDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

Définit la taille par défaut des polices à largeur fixe.

Paramètres

  • détails

    objet

    • pixelSize

      Nombre

      Taille de la police en pixels.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

setDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

Définit la taille de police par défaut.

Paramètres

  • détails

    objet

    • pixelSize

      Nombre

      Taille de la police en pixels.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

setFont()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

Définit la police d'un script et d'une famille de polices génériques donnés.

Paramètres

  • détails

    objet

    • fontId

      chaîne

      ID de la police. Une chaîne vide correspond au paramètre de police global du script.

    • genericFamily

      GenericFamily

      Famille de polices génériques pour laquelle la police doit être définie.

    • écriture

      ScriptCode facultatif

      Code de script pour lequel la police doit être définie. Si cette valeur est omise, le paramètre de police du script global (code de script "Zyyy") est défini.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

setMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

Définit la taille de police minimale.

Paramètres

  • détails

    objet

    • pixelSize

      Nombre

      Taille de la police en pixels.

  • rappel

    function facultatif

    Le paramètre callback se présente comme suit: 

    () => void

Renvoie

  • Promesse<void>

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

Événements

onDefaultFixedFontSizeChanged

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

Déclenché lorsque le paramètre de taille de police fixe par défaut est modifié.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.

onDefaultFontSizeChanged

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

Déclenché lorsque le paramètre de taille de police par défaut est modifié.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.

onFontChanged

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

Déclenché lors de la modification d'un paramètre de police.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • fontId

        chaîne

        ID de la police. Consultez la description en getFont.

      • genericFamily

        GenericFamily

        Famille de polices génériques pour laquelle le paramètre de police a été modifié.

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • écriture

        ScriptCode facultatif

        Code de script pour lequel le paramètre de police a été modifié.

onMinimumFontSizeChanged

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

Déclenché lorsque le paramètre de taille de police minimale est modifié.

Paramètres

  • rappel

    fonction

    Le paramètre callback se présente comme suit: 

    (details: object) => void

    • détails

      objet

      • levelOfControl

        LevelOfControl

        Niveau de contrôle de cette extension sur le paramètre.

      • pixelSize

        Nombre

        Taille de la police en pixels.