chrome.fontSettings

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.fontSettings per gestire le impostazioni dei caratteri di Chrome.

Autorizzazioni

fontSettings

Manifest

Per utilizzare l'API Font Settings, devi dichiarare l'autorizzazione "fontSettings" nel manifest dell'estensione. Ad esempio:

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

Famiglie di caratteri e script generici

Chrome consente di impostare alcune impostazioni dei caratteri in base a determinate famiglie di caratteri generici e script di lingua. Ad esempio, il carattere utilizzato per il cinese semplificato sans-serif potrebbe essere diverso da quello utilizzato per il giapponese serif.

Le famiglie di caratteri generiche supportate da Chrome si basano sulle famiglie di caratteri generiche CSS e sono elencate nel riferimento API riportato di seguito. Quando una pagina web specifica una famiglia di caratteri generica, Chrome seleziona il carattere in base all'impostazione corrispondente. Se non viene specificata alcuna famiglia di caratteri generica, Chrome utilizza l'impostazione per la famiglia di caratteri generica "standard".

Quando una pagina web specifica una lingua, Chrome seleziona il carattere in base all'impostazione per lo script della lingua corrispondente. Se non viene specificata alcuna lingua, Chrome utilizza l'impostazione per lo script predefinito o globale.

I sistemi di scrittura delle lingue supportati sono specificati dal codice di scrittura ISO 15924 ed elencati nel riferimento API riportato di seguito. Tecnicamente, le impostazioni di Chrome non sono strettamente per script, ma dipendono anche dalla lingua. Ad esempio, Chrome sceglie il carattere per il cirillico (codice script ISO 15924 "Cyrl") quando una pagina web specifica la lingua russa e utilizza questo carattere non solo per il cirillico, ma per tutto ciò che il carattere copre, ad esempio il latino.

Esempi

Il seguente codice recupera il carattere standard per l'arabo.

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

Lo snippet successivo imposta il carattere sans-serif per il giapponese.

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

Per provare questa API, installa l'esempio di API fontSettings dal repository chrome-extension-samples.

Tipi

FontName

Rappresenta un nome di carattere.

Proprietà

  • displayName

    stringa

    Il nome visualizzato del carattere.

  • fontId

    stringa

    L'ID carattere.

GenericFamily

Una famiglia di caratteri generica CSS.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"corsivo"

"fantasy"

"math"

LevelOfControl

Uno dei seguenti not\_controllable: non può essere controllato da alcuna estensione controlled\_by\_other\_extensions: controllato da estensioni con priorità più elevata controllable\_by\_this\_extension: può essere controllato da questa estensione controlled\_by\_this\_extension: controllato da questa estensione

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Un codice script ISO 15924. Lo script predefinito o globale è rappresentato dal codice script "Zyyy".

Enum

"Afak"

"Arab"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bassi"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Cans"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hang"

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

"Arto"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"Luna"

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

"Thai"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Metodi

clearDefaultFixedFontSize()

Promessa 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<void>

Cancella la dimensione del carattere fissa predefinita impostata da questa estensione, se presente.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

clearDefaultFontSize()

Promessa 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<void>

Cancella la dimensione del carattere predefinita impostata da questa estensione, se presente.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

clearFont()

Promessa 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
): Promise<void>

Cancella il carattere impostato da questa estensione, se presente.

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

      La famiglia di caratteri generica per cui deve essere cancellato il carattere.

    • scrittura

      ScriptCode facoltativo

      Lo script per cui deve essere cancellato il carattere. Se omesso, l'impostazione del carattere dello script globale viene cancellata.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

clearMinimumFontSize()

Promessa 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<void>

Cancella la dimensione minima del carattere impostata da questa estensione, se presente.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getDefaultFixedFontSize()

Promessa 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Ottiene la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getDefaultFontSize()

Promessa 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Recupera la dimensione del carattere predefinita.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getFont()

Promessa 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
): Promise<object>

Recupera il carattere per un determinato script e una famiglia di caratteri generica.

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

      La famiglia di caratteri generica per cui deve essere recuperato il carattere.

    • scrittura

      ScriptCode facoltativo

      Lo script per cui deve essere recuperato il carattere. Se omesso, viene recuperata l'impostazione del carattere per lo script globale (codice script "Zyyy").

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

        L'ID carattere. Anziché il valore letterale della preferenza dell'ID carattere, potrebbe trattarsi dell'ID del carattere a cui il sistema risolve il valore della preferenza. Pertanto, fontId può differire dal carattere passato a setFont, ad esempio se il carattere non è disponibile sul sistema. La stringa vuota indica il fallback all'impostazione globale del carattere dello script.

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

Resi

  • Promise<object>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getFontList()

Promessa 
chrome.fontSettings.getFontList(
  callback?: function,
): Promise<FontName[]>

Recupera un elenco di caratteri sul sistema.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (results: FontName[]) => void

Resi

  • Promise<FontName[]>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getMinimumFontSize()

Promessa 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<object>

Restituisce la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

setDefaultFixedFontSize()

Promessa 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
): Promise<void>

Imposta la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

setDefaultFontSize()

Promessa 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
): Promise<void>

Imposta la dimensione del carattere predefinita.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

setFont()

Promessa 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
): Promise<void>

Imposta il carattere per un determinato script e una famiglia di caratteri generica.

Parametri

  • dettagli

    oggetto

    • fontId

      stringa

      L'ID carattere. La stringa vuota indica di ripristinare l'impostazione globale del carattere dello script.

    • genericFamily

      GenericFamily

      La famiglia di caratteri generica per cui deve essere impostato il carattere.

    • scrittura

      ScriptCode facoltativo

      Il codice dello script per cui deve essere impostato il carattere. Se omesso, viene impostata l'impostazione del carattere per lo script globale (codice script "Zyyy").

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

setMinimumFontSize()

Promessa 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
): Promise<void>

Imposta la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

Eventi

onDefaultFixedFontSizeChanged

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

Attivato quando cambia l'impostazione predefinita della dimensione del carattere fissa.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onDefaultFontSizeChanged

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

Attivato quando cambia l'impostazione predefinita della dimensione del carattere.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onFontChanged

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

Attivato quando viene modificata un'impostazione del carattere.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

        L'ID carattere. Consulta la descrizione in getFont.

      • genericFamily

        GenericFamily

        La famiglia di caratteri generica per cui è stata modificata l'impostazione del carattere.

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • scrittura

        ScriptCode facoltativo

        Il codice dello script per cui è stata modificata l'impostazione del carattere.

onMinimumFontSizeChanged

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

Attivato quando cambia l'impostazione della dimensione minima del carattere.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.