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 generici e script

Chrome consente di basare alcune impostazioni dei caratteri su 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 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 dello script della lingua corrispondente. Se non viene specificata alcuna lingua, Chrome utilizza l'impostazione per lo script predefinito o globale.

Gli script delle lingue supportate sono specificati dal codice script ISO 15924 ed elencati nel riferimento API di seguito. Tecnicamente, le impostazioni di Chrome non sono strettamente specifiche per lo script, ma dipendono anche dalla lingua. Ad esempio, Chrome sceglie il carattere per il cirillico (codice di scrittura ISO 15924 "Cyrl") quando una pagina web specifica la lingua russa e utilizza questo carattere non solo per la scrittura cirillica, 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 il nome di un carattere.

Proprietà

  • displayName

    stringa

    Il nome visualizzato del carattere.

  • fontId

    stringa

    L'ID del carattere.

GenericFamily

Una famiglia di caratteri generica CSS.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"fantasy"

"math"

LevelOfControl

Uno dei seguenti valori: not\_controllable: non può essere controllata da alcuna estensione controlled\_by\_other\_extensions: controllata da estensioni con precedenza maggiore controllable\_by\_this\_extension: può essere controllata da questa estensione controlled\_by\_this\_extension: controllata da questa estensione

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

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

Enum

"Afak"

"Arab"

"Aran"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bass"

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

"Bloccato"

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

"Mend"

"Merc"

"Mero"

"Mlym"

"Moon"

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

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

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

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

clearDefaultFontSize()

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

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

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

clearFont()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

clearMinimumFontSize()

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

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

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

getDefaultFixedFontSize()

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

Recupera la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    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 e versioni successive

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

getDefaultFontSize()

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

Recupera la dimensione del carattere predefinita.

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    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 e versioni successive

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

getFont()

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

Recupera il carattere per uno script e una famiglia di caratteri generica specificati.

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

      La famiglia di caratteri generica per cui recuperare 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

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

      • levelOfControl

        LevelOfControl

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

Resi

  • Promise<object>

    Chrome 96 e versioni successive

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

getFontList()

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

Recupera un elenco di caratteri sul sistema.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (results: FontName[]) => void

Resi

  • Promise<FontName[]>

    Chrome 96 e versioni successive

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

getMinimumFontSize()

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

Restituisce la dimensione minima del carattere.

Parametri

  • dettagli

    object facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    funzione elemento facoltativo

    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 e versioni successive

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

setDefaultFixedFontSize()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

setDefaultFontSize()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

setFont()

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

Imposta il carattere per uno script e una famiglia di caratteri generica specifici.

Parametri

  • dettagli

    oggetto

    • fontId

      stringa

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

    • 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

setMinimumFontSize()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

Eventi

onDefaultFixedFontSizeChanged

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

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

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 l'impostazione predefinita della dimensione del carattere cambia.

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 cambia un'impostazione dei caratteri.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

        L'ID del carattere. Consulta la descrizione in getFont.

      • genericFamily

        GenericFamily

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

      • 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 l'impostazione della dimensione minima del carattere cambia.

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.