browser.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 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 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 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 in ScriptCode. 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.

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

Lo snippet successivo imposta il carattere sans-serif per il giapponese.

browser.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()

browser.fontSettings.clearDefaultFixedFontSize(
  details?: object,
): 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.

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

clearDefaultFontSize()

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

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

Parametri

• dettagli

  object facoltativo

  Questo parametro non è al momento utilizzato.

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

clearFont()

browser.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 omesso, l'impostazione del carattere dello script globale viene cancellata.

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

clearMinimumFontSize()

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

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

Parametri

• dettagli

  object facoltativo

  Questo parametro non è al momento utilizzato.

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

getDefaultFixedFontSize()

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

Recupera la dimensione predefinita per i caratteri a larghezza fissa.

Parametri

• dettagli

  object facoltativo

  Questo parametro non è al momento utilizzato.

Resi

• Promise<object>

  Browser Chrome 96+ .* da Chrome 148

getDefaultFontSize()

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

Recupera la dimensione del carattere predefinita.

Parametri

• dettagli

  object facoltativo

  Questo parametro non è al momento utilizzato.

Resi

• Promise<object>

  Browser Chrome 96+ .* da Chrome 148

getFont()

browser.fontSettings.getFont(
  details: object,
): 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").

Resi

• Promise<object>

  Browser Chrome 96+ .* da Chrome 148

getFontList()

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

Recupera un elenco di caratteri sul sistema.

Resi

• Promise<FontName[]>

  Browser Chrome 96+ .* da Chrome 148

getMinimumFontSize()

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

Restituisce la dimensione minima del carattere.

Parametri

• dettagli

  object facoltativo

  Questo parametro non è al momento utilizzato.

Resi

• Promise<object>

  Browser Chrome 96+ .* da Chrome 148

setDefaultFixedFontSize()

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

  Browser Chrome 96+ .* da Chrome 148

setDefaultFontSize()

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

Imposta la dimensione del carattere predefinita.

Parametri

• dettagli

  oggetto

  • pixelSize

    numero

    Le dimensioni del carattere in pixel.

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

setFont()

browser.fontSettings.setFont(
  details: object,
): 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").

Resi

• Promise<void>

  Browser Chrome 96+ .* da Chrome 148

setMinimumFontSize()

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

  Browser Chrome 96+ .* da Chrome 148

Eventi

onDefaultFixedFontSizeChanged

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

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

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

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