Descrizione
Usa l'API chrome.fontSettings
per gestire le impostazioni dei caratteri di Chrome.
Autorizzazioni
fontSettings
Manifest
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"
],
...
}
Famiglie di caratteri e script generici
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 nel riferimento API di seguito. 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 dei linguaggi supportati sono specificati dal codice di script ISO 15924 ed elencati nei riferimenti API riportati di seguito. 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()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
clearDefaultFontSize()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
clearFont()
chrome.fontSettings.clearFont(
details: object,
callback?: function,
)
Cancella il carattere impostato da questa estensione, se presente.
Parametri
-
dettagli
oggetto
-
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
clearMinimumFontSize()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDefaultFixedFontSize()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getDefaultFontSize()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getFont()
chrome.fontSettings.getFont(
details: object,
callback?: function,
)
Restituisce il carattere per uno script specifico e una famiglia di caratteri generica.
Parametri
-
dettagli
oggetto
-
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 asetFont
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
Il livello di controllo che questa estensione ha sull'impostazione.
-
-
Ritorni
-
Promise<object>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getFontList()
chrome.fontSettings.getFontList(
callback?: function,
)
Consente di acquisire un elenco di caratteri sul sistema.
Parametri
Ritorni
-
Promise<FontName[]>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getMinimumFontSize()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setDefaultFixedFontSize()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setDefaultFontSize()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setFont()
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
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setMinimumFontSize()
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 successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i 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
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
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
La famiglia di caratteri generica per cui è stata modificata l'impostazione dei caratteri.
-
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
Il livello di controllo che questa estensione ha sull'impostazione.
-
pixelSize
numero
Le dimensioni del carattere in pixel.
-
-