chrome.fontSettings

Descrizione

Usa 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 dipendono da determinate famiglie di caratteri generici e script di lingua. Ad esempio, il font utilizzato per il cinese semplificato senza grazie potrebbe essere diverso da quello utilizzato per il giapponese serif.

Le famiglie di caratteri generici supportate da Chrome sono basate su 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 usa l'impostazione per la famiglia di caratteri generici "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 in lingue supportati sono specificati dal codice di script ISO 15924 ed elencati sotto ScriptCode. Tecnicamente, le impostazioni di Chrome non dipendono esclusivamente da ogni script, ma dipendono anche dalla lingua. Ad esempio, Chrome sceglie il carattere cirillico (codice di script ISO 15924 "Cyrl") quando una pagina web specifica la lingua russa e lo utilizza non solo per la scrittura cirillica, ma per tutto ciò che viene coperto dal carattere, ad esempio il latino.

Esempi

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

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

Lo snippet successivo imposta il font senza grazie 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 carattere.

GenericFamily

Una famiglia di caratteri CSS generici.

Enum

"standard"

"fantasy"

LevelOfControl

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

Enum

"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 dello script "Zyyy".

Enum

"Afak"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Batk"

"Beng"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Cari"

"Cham"

"Cher"

"Cirt"

"Cprt"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Elba"

"Ethi"

"Geor"

"Geok"

"Goth"

"Grek"

"Gujr"

"Guru"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Inds"

"Java"

"Jpan"

"Jurc"

"Kali"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Limb"

"Lina"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Merc"

"Mero"

"Mlym"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Perm"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Sara"

"Sarb"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Sylo"

"Syrc"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Tale"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Metodi

clearDefaultFixedFontSize()

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

Cancella le dimensioni predefinite dei caratteri fisse impostate da questa estensione, se presenti.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

clearDefaultFontSize()

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

Cancella le dimensioni predefinite dei caratteri impostate da questa estensione, se presenti.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso 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 cui cancellare il carattere.

    • scrittura

      ScriptCode facoltativo

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

clearMinimumFontSize()

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

Cancella le dimensioni minime dei caratteri impostate da questa estensione, se presenti.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

getDefaultFixedFontSize()

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

Restituisce le dimensioni predefinite per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è 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.

Ritorni

  • Promise<object>

    Chrome 96 e versioni successive

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

getDefaultFontSize()

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

Restituisce la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è 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.

Ritorni

  • Promise<object>

    Chrome 96 e versioni successive

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

getFont()

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

Restituisce il carattere per uno script specifico 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 il quale 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 in cui il sistema risolve il valore della preferenza. Di conseguenza, fontId può essere diverso dal carattere trasmesso a setFont se, ad esempio, il carattere non è disponibile nel sistema. La stringa vuota indica un'impostazione di riserva per l'impostazione globale del carattere dello script.

      • levelOfControl

        LevelOfControl

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

Ritorni

  • Promise<object>

    Chrome 96 e versioni successive

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

getFontList()

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

Consente di acquisire un elenco di caratteri sul sistema.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (results: FontName[])=>void

Ritorni

  • Promise<FontName[]>

    Chrome 96 e versioni successive

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

getMinimumFontSize()

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

Consente di acquisire le dimensioni minime dei caratteri.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro al momento non è 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.

Ritorni

  • Promise<object>

    Chrome 96 e versioni successive

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

setDefaultFixedFontSize()

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

Imposta le dimensioni predefinite 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

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

setDefaultFontSize()

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

Imposta la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

setFont()

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

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

Parametri

  • dettagli

    oggetto

    • fontId

      stringa

      L'ID carattere. La stringa vuota indica di ricorrere all'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 su cui impostare 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

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso 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

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

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

Eventi

onDefaultFixedFontSizeChanged

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

Viene attivato quando viene modificata l'impostazione predefinita per le 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 che questa estensione ha sull'impostazione.

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onDefaultFontSizeChanged

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

Attivato quando viene modificata l'impostazione predefinita delle dimensioni 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. Vedi 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 il quale è stata modificata l'impostazione del carattere.

onMinimumFontSizeChanged

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

Attivato quando viene modificata l'impostazione relativa alle dimensioni minime dei caratteri.

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.