chrome.fontSettings

Descrizione

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

Autorizzazioni

fontSettings

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"
  ],
  ...
}

Concetti e utilizzo

Chrome consente che alcune impostazioni dei caratteri dipendano da determinate famiglie di caratteri generici e da script di lingua. Ad esempio, il carattere utilizzato per il cinese semplificato senza grazie potrebbe essere diverso da quello utilizzato per il giapponese con grazie.

Le famiglie di caratteri generiche supportate da Chrome si basano sulle famiglie di caratteri generici CSS e sono elencate in GenericReference. 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 ISO 15924 e elencati in ScriptCode. Tecnicamente, le impostazioni di Chrome non sono strettamente per script, ma dipendono anche dal linguaggio. Ad esempio, Chrome sceglie il carattere cirillico (codice dello script ISO 15924 "Cyrl") quando una pagina web specifica la lingua russa e utilizza questo carattere non solo per lo script cirillico, ma per tutto ciò che 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 dell'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 controllato da nessuna estensione controlled\_by\_other\_extensions: controllato dalle estensioni con precedenza 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"

"Arabo"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Basso"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Lattine"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copto"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Attendi"

"Hani"

"Hano"

"Hans"

"Hant"

"Ebraico"

"Hluw"

"Hmng"

"Chiamata persa"

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

"Ripara"

"Merc"

"Mero"

"Mlym"

"Luna"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palmo"

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

"Tamil"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thai"

"Tibet"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Metodi

clearDefaultFixedFontSize()

Promessa 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

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

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

clearDefaultFontSize()

Promessa 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

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

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

clearFont()

Promessa 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

Cancella il carattere impostato da questa estensione, se presente.

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

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

    • scrittura

      ScriptCode facoltativo

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

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

clearMinimumFontSize()

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

Se presente, cancella la dimensione minima dei caratteri impostata da questa estensione.

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getDefaultFixedFontSize()

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

Restituisce la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getDefaultFontSize()

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

Restituisce la dimensione del carattere predefinita.

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getFont()

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

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

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

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

    • scrittura

      ScriptCode facoltativo

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

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

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

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

Resi

  • Promise<object>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getFontList()

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

Recupera un elenco di caratteri sul sistema.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (results: FontName[]) => void

Resi

  • Promise<FontName[]>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getMinimumFontSize()

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

Restituisce la dimensione minima del carattere.

Parametri

  • dettagli

    Oggetto facoltativo

    Questo parametro non è al momento utilizzato.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

Resi

  • Promise<object>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setDefaultFixedFontSize()

Promessa 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

Imposta la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setDefaultFontSize()

Promessa 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

Imposta la dimensione del carattere predefinita.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setFont()

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

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

Parametri

  • dettagli

    oggetto

    • fontId

      stringa

      L'ID del carattere. La stringa vuota indica di eseguire il fallback all'impostazione del carattere dello script globale.

    • genericFamily

      GenericFamily

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

    • scrittura

      ScriptCode facoltativo

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

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setMinimumFontSize()

Promessa 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

Imposta la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

Eventi

onDefaultFixedFontSizeChanged

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

Viene attivato quando viene modificata l'impostazione predefinita delle dimensioni dei caratteri fisse.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onDefaultFontSizeChanged

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

Viene attivato quando cambia l'impostazione predefinita delle dimensioni dei caratteri.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onFontChanged

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

Viene attivato quando cambia un'impostazione del carattere.

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 la quale è stata modificata l'impostazione del carattere.

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • scrittura

        ScriptCode facoltativo

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

onMinimumFontSizeChanged

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

Viene attivato quando l'impostazione delle dimensioni minime dei caratteri cambia.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo esercitato da questa estensione sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.