chrome.fontSettings

Description

Utilisez l'API chrome.fontSettings pour gérer les paramètres de police de Chrome.

Autorisations

fontSettings

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

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

Concepts et utilisation

Chrome permet à certains paramètres de police de dépendre de certaines familles de polices génériques et de scripts de langue. Par exemple, la police utilisée pour le chinois simplifié sans serif peut être différente de celle utilisée pour le japonais serif.

Les familles de polices génériques compatibles avec Chrome sont basées sur les familles de polices génériques CSS et sont listées 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 le paramètre de la famille de polices génériques "standard".

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

Les scripts de langue acceptés sont spécifiés par le code de script ISO 15924 et répertoriés sous ScriptCode. Techniquement, les paramètres Chrome ne sont pas strictement définis par script, mais dépendent également de la langue. Par exemple, Chrome choisit la police pour le cyrillique (code de script ISO 15924 "Cyrl") lorsqu'une page Web spécifie la langue russe, et utilise cette police non seulement pour le script cyrillique, mais pour tout ce qu'elle couvre, comme le latin.

Exemples

Le code suivant obtient 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 du dépôt chrome-extension-samples.

Types

FontName

Représente un nom de police.

Propriétés

  • displayName

    chaîne

    Nom à afficher de la police.

  • fontId

    chaîne

    ID de la police.

GenericFamily

Famille de polices générique CSS.

Énumération

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"fantasy"

"math"

LevelOfControl

L'un des éléments suivants : 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"

"Bass" (Basse) 

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Braille"

"Bugi"

"Buhd"

"Cakm"

"Cans" (Canettes) 

"Cari"

"Cham"

"Cher"

"Cirt"

"Copte"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Suspendre"

"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" (Limb)

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Réparer"

"Merc"

"Mero"

"Mlym"

"Lune"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palm"

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

"Tale"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thaïlandais"

"Tibet"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Méthodes

clearDefaultFixedFontSize()

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 pas utilisé pour le moment.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

clearDefaultFontSize()

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 pas utilisé pour le moment.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

clearFont()

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érique 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 de script global est effacé.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

clearMinimumFontSize()

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

Efface 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 pas utilisé pour le moment.

  • rappel

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getDefaultFixedFontSize()

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 pas utilisé pour le moment.

  • rappel

    fonction 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<object>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getDefaultFontSize()

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 pas utilisé pour le moment.

  • rappel

    fonction 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<object>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getFont()

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

Récupère la police pour un script et une famille de polices génériques donnés.

Paramètres

  • détails

    objet

    • genericFamily

      GenericFamily

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

    • écriture

      ScriptCode facultatif

      Script pour lequel la police doit être récupérée. Si ce paramètre est omis, le paramètre de police du script global (code de script "Zyyy") est récupéré.

  • rappel

    fonction 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 la valeur littérale de la préférence d'ID de police, il peut s'agir de l'ID de la police à laquelle le système résout la valeur de préférence. Par conséquent, fontId peut différer de la police transmise à setFont, par exemple si la police n'est pas disponible sur le système. La chaîne vide indique le recours au paramètre de police de script global.

      • levelOfControl

        LevelOfControl

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

Renvoie

  • Promise<object>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getFontList()

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

Récupère la liste des polices du système.

Paramètres

  • rappel

    fonction facultatif

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

    (results: FontName[]) => void

Renvoie

  • Promise<FontName[]>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getMinimumFontSize()

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 pas utilisé pour le moment.

  • rappel

    fonction 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<object>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

setDefaultFixedFontSize()

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

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

setDefaultFontSize()

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

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

setFont()

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

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

Paramètres

  • détails

    objet

    • fontId

      chaîne

      ID de la police. La chaîne vide signifie que le paramètre de police de script global est utilisé.

    • genericFamily

      GenericFamily

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

    • écriture

      ScriptCode facultatif

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

  • rappel

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

setMinimumFontSize()

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

    fonction facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout 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 change.

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

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é lorsqu'un paramètre de police change.

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 dans getFont.

      • genericFamily

        GenericFamily

        Famille de polices générique 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 du 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 change.

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.