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 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 nella sezione 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 supportati sono specificati dal codice di scrittura ISO 15924 ed elencati in ScriptCode. 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 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); }
);

Il seguente snippet 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"

"corsivo"

"fantasy"

"math"

LevelOfControl

Uno dei 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 di scrittura ISO 15924. Lo script predefinito o globale è rappresentato dal codice script "Zyyy".

Enum

"Afak"

"Arabo"

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

"Limb"

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

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

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Thai"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Metodi

clearDefaultFixedFontSize()

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

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

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<void>

    Chrome 96+

clearDefaultFontSize()

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

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

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<void>

    Chrome 96+

clearFont()

chrome.fontSettings.clearFont(
  details: object,
): 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 la proprietà viene omessa, l'impostazione del carattere dello script globale viene cancellata.

Resi

  • Promise<void>

    Chrome 96+

clearMinimumFontSize()

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

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

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<void>

    Chrome 96+

getDefaultFixedFontSize()

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

Recupera la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<object>

    Chrome 96+

getDefaultFontSize()

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

Recupera la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<object>

    Chrome 96+

getFont()

chrome.fontSettings.getFont(
  details: object,
): 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 omessa, viene recuperata l'impostazione del carattere per lo script globale (codice script "Zyyy").

Resi

  • Promise<object>

    Chrome 96+

getFontList()

chrome.fontSettings.getFontList(): Promise<FontName[]>

Recupera un elenco di caratteri sul sistema.

Resi

getMinimumFontSize()

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

Restituisce la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto facoltativo

    Questo parametro non è attualmente utilizzato.

Resi

  • Promise<object>

    Chrome 96+

setDefaultFixedFontSize()

chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
): Promise<void>

Imposta la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

Resi

  • Promise<void>

    Chrome 96+

setDefaultFontSize()

chrome.fontSettings.setDefaultFontSize(
  details: object,
): Promise<void>

Imposta la dimensione predefinita del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

Resi

  • Promise<void>

    Chrome 96+

setFont()

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

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 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 viene omesso, viene impostata l'impostazione del carattere per lo script globale (codice script "Zyyy").

Resi

  • Promise<void>

    Chrome 96+

setMinimumFontSize()

chrome.fontSettings.setMinimumFontSize(
  details: object,
): Promise<void>

Imposta la dimensione minima del carattere.

Parametri

  • dettagli

    oggetto

    • pixelSize

      numero

      Le dimensioni del carattere in pixel.

Resi

  • Promise<void>

    Chrome 96+

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

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.

onFontChanged

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

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 cui è 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,
)

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

      • pixelSize

        numero

        Le dimensioni del carattere in pixel.