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" nell'estensione del file manifest. Ad esempio:

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

Concetti e utilizzo

Chrome consente la dipendenza di alcune impostazioni dei caratteri da determinate famiglie di caratteri generici e da un linguaggio script. Ad esempio, il carattere utilizzato per il cinese semplificato senza grazie potrebbe essere diverso dal carattere utilizzato per il giapponese Serif.

Le famiglie di caratteri generici supportate da Chrome si basano sulle famiglie di caratteri CSS generiche e sono elencato in GenericReference. Quando una pagina web specifica una famiglia di caratteri generica, Chrome seleziona del carattere in base all'impostazione corrispondente. Se non viene specificata alcuna famiglia di caratteri generica, Chrome utilizza la classe di caratteri l'impostazione "Standard" una famiglia di caratteri generica.

Quando una pagina web specifica una lingua, Chrome seleziona il carattere in base all'impostazione dei scrittura del linguaggio corrispondente. Se non viene specificata alcuna lingua, Chrome utilizza l'impostazione per o globale.

Gli script in lingua supportati sono specificati dal codice di script ISO 15924 ed elencati nella ScriptCode Tecnicamente, le impostazioni di Chrome non sono strettamente legate allo script, ma dipendono anche lingua. Ad esempio, Chrome sceglie il carattere per il cirillico (codice di script ISO 15924 "Cyrl") quando specifica la lingua russa e utilizza questo font non solo per la scrittura cirillico, ma anche per tutto ciò che copre il carattere, come 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 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 da chrome-extension-samples repository Git.

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

Enum

"standard"

"sans Serif"

"Serif"

"fisso"

"corsivo"

"fantasy"

"math"

LevelOfControl

Uno di not\_controllable: non può essere controllato da nessuna estensione controlled\_by\_other\_extensions: controllata da estensioni con precedenza più alta controllable\_by\_this\_extension: può essere controllato 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 script ISO 15924. Lo script predefinito, o globale, è rappresentato dal codice dello script "Zyyy".

Enum

"Afak"

"Arabo"

"Armi"

"Abilita"

"Avst"

"Bali"

"Bamu"

"Bassi"

"Batti"

"Beng"

"Blis"

"Bopo"

"Bruno"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Lattine"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Aggancia"

"Hani"

"Hano"

"Han"

"Hant"

"Ebr"

"Hluw"

"Mh"

"Sospeso"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"Kali"

"Kara"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Laura"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Arti"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maia"

"Menda"

"Merc"

"Mero"

"Mlym"

"Luna"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Oria"

"Osma"

"Palma"

"Perm"

"Pago"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Corsa"

"Samu"

"Sara"

"Sarb"

"Sauro"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Sund"

"Sylo"

"Syrc"

"Tiro"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Racconto"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Tailandese"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zm"

"Zsym"

"Zyyy"

Metodi

clearDefaultFixedFontSize()

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

Consente di cancellare le dimensioni predefinite dei caratteri fisse impostate da questa estensione, se presenti.

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

clearDefaultFontSize()

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

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

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

clearFont()

Promesso .
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 il carattere deve essere cancellato.

    • scrittura

      ScriptCode facoltativo

      Lo script per il quale 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

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

clearMinimumFontSize()

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

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

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getDefaultFixedFontSize()

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

Restituisce la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.

Resi

  • Promise&lt;object&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getDefaultFontSize()

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

Recupera la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.

Resi

  • Promise&lt;object&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getFont()

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

Restituisce il carattere di uno script specifico e una famiglia di caratteri generici.

Parametri

  • dettagli

    oggetto

    • genericFamily

      GenericFamily

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

    • 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 dello 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 ID carattere, potrebbe trattarsi dell'ID del carattere in cui il sistema risolve il valore della preferenza. Pertanto, fontId può differire dal carattere trasmesso a setFont se, ad esempio, il carattere non è disponibile nel sistema. La stringa vuota indica il fallback all'impostazione del carattere dello script globale.

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

Resi

  • Promise&lt;object&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getFontList()

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

Recupera un elenco di caratteri sul sistema.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (results: FontName[]) => void

Resi

  • Promise&lt;FontName[]&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getMinimumFontSize()

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

Restituisce la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Al momento questo parametro non è utilizzato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.

Resi

  • Promise&lt;object&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setDefaultFixedFontSize()

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

Imposta la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      La dimensione del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setDefaultFontSize()

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

Imposta la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      La dimensione del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setFont()

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

Imposta il carattere per uno script specifico e una famiglia di caratteri generici.

Parametri

  • dettagli

    oggetto

    • fontId

      stringa

      L'ID carattere. La stringa vuota indica di riservare 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 da impostare per il carattere. Se omesso, viene configurata l'impostazione del carattere per lo script globale (codice dello script "Zyyy").

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setMinimumFontSize()

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

Imposta la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      La dimensione del carattere in pixel.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

Eventi

onDefaultFixedFontSizeChanged

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

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 di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.

onDefaultFontSizeChanged

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

Attivato quando viene modificata l'impostazione delle dimensioni predefinite dei caratteri.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.

onFontChanged

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

Attivato quando viene modificata l'impostazione di un carattere.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • fontId

        stringa

        L'ID carattere. Leggi la descrizione in getFont.

      • genericFamily

        GenericFamily

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

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione 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 della dimensione minima dei caratteri.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (details: object) => void

    • dettagli

      oggetto

      • levelOfControl

        LevelOfControl

        Il livello di controllo di questa estensione sull'impostazione.

      • pixelSize

        numero

        La dimensione del carattere in pixel.