Opis
Do zarządzania ustawieniami czcionek Chrome używaj interfejsu API chrome.fontSettings
.
Uprawnienia
fontSettings
Plik manifestu
Aby korzystać z interfejsu Font Settings API, musisz zadeklarować uprawnienie „fontSettings” w pliku manifestu rozszerzenia. Na przykład:
{
"name": "My Font Settings Extension",
"description": "Customize your fonts",
"version": "0.2",
"permissions": [
"fontSettings"
],
...
}
Ogólne rodziny czcionek i skrypty
Niektóre ustawienia czcionek w Chrome zależą od określonych rodzin czcionek i skryptów językowych. Na przykład czcionka w języku chińskim uproszczonym bezszeryfowym może być inna niż w przypadku języka japońskiego szeryfowego.
Ogólne rodziny czcionek obsługiwane w Chrome bazują na ogólnych rodzinach czcionek CSS i są wymienione w dokumentacji interfejsów API poniżej. Gdy strona internetowa określa ogólną rodzinę czcionek, Chrome wybiera czcionkę na podstawie odpowiedniego ustawienia. Jeśli nie określisz ogólnej rodziny czcionek, Chrome użyje ustawienia „standardowej” rodziny czcionek.
Gdy język strony jest określony, Chrome wybiera czcionkę na podstawie ustawień odpowiedniego skryptu języka. Jeśli nie określisz języka, Chrome użyje ustawienia domyślnego lub globalnego skryptu.
Obsługiwane skrypty języka są określone za pomocą kodu skryptu ISO 15924 i wymienione w dokumentacji interfejsu API poniżej. Ustawienia Chrome nie są ściśle określone przez skrypt, lecz także zależą od języka. Na przykład Chrome wybiera czcionkę cyrylicy (kod pisma w standardzie ISO 15924 „Cyrl”), gdy strona internetowa zawiera język rosyjski, i używa tej czcionki nie tylko w przypadku cyrylicy, ale także do wszystkich części czcionki, takich jak alfabet łaciński.
Przykłady
Ten kod pobiera standardową czcionkę dla języka arabskiego.
chrome.fontSettings.getFont(
{ genericFamily: 'standard', script: 'Arab' },
function(details) { console.log(details.fontId); }
);
Następny fragment ustawia czcionkę bezszeryfową dla języka japońskiego.
chrome.fontSettings.setFont(
{ genericFamily: 'sansserif', script: 'Jpan', fontId: 'MS PGothic' }
);
Aby go wypróbować, zainstaluj przykładowy interfejs API fontSettings z repozytorium chrome-extension-samples.
Typy
FontName
Reprezentuje nazwę czcionki.
Właściwości
-
displayName
string,
Wyświetlana nazwa czcionki.
-
fontId
string,
Identyfikator czcionki.
GenericFamily
Ogólna rodzina czcionek CSS.
Enum
"sansserif"
"fantasy"
LevelOfControl
Jedna z tych wartości:
not\_controllable
: nie może być kontrolowana przez żadne rozszerzenie
controlled\_by\_other\_extensions
: sterowana przez rozszerzenia o wyższym priorytecie
controllable\_by\_this\_extension
: może być kontrolowana przez to rozszerzenie
controlled\_by\_this\_extension
: kontrolowane przez to rozszerzenie
Enum
"not_controllable"
"controlled_by_other_extensions"
"controllable_by_this_extension"
"controlled_by_this_extension"
ScriptCode
Kod skryptu w formacie ISO 15924. Skrypt domyślny (globalny) jest reprezentowany przez kod „Zyyy”.
Enum
"Cyrs"
"Geor"
"Geok"
"Glag"
"Grek"
"Gujr"
"Inds"
"Khar"
"Khmr"
"Limb"
"Linb"
"Lyci"
"Mong"
"Phag"
"Phlp"
"Phlv"
"Rjng"
"Sarb"
"Sgnw"
"Shaw"
"Shrd"
"Sora"
"Sylo"
"Syrc"
"Syre"
"Syrj"
"Syrn"
"Zsym"
Metody
clearDefaultFixedFontSize()
chrome.fontSettings.clearDefaultFixedFontSize(
details?: object,
callback?: function,
)
Usuwa domyślny stały rozmiar czcionki ustawiony przez to rozszerzenie (jeśli istnieje).
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
clearDefaultFontSize()
chrome.fontSettings.clearDefaultFontSize(
details?: object,
callback?: function,
)
Usuwa domyślny rozmiar czcionki ustawiony przez to rozszerzenie (jeśli istnieje).
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
clearFont()
chrome.fontSettings.clearFont(
details: object,
callback?: function,
)
Usuwa czcionkę ustawioną przez to rozszerzenie (jeśli istnieje).
Parametry
-
szczegóły
obiekt
-
genericFamily
Ogólna rodzina czcionek, z których czcionka powinna zostać wyczyszczona.
-
pismo
Opcjonalny ScriptCode
Skrypt, dla którego należy wyczyścić czcionkę. W przypadku jego pominięcia ustawienie czcionki skryptu globalnego zostanie wyczyszczone.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
clearMinimumFontSize()
chrome.fontSettings.clearMinimumFontSize(
details?: object,
callback?: function,
)
Usuwa minimalny rozmiar czcionki ustawiony przez to rozszerzenie (jeśli jest ustawiony).
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getDefaultFixedFontSize()
chrome.fontSettings.getDefaultFixedFontSize(
details?: object,
callback?: function,
)
Pobiera domyślny rozmiar czcionek o stałej szerokości.
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
Akcje powrotne
-
Promise<object>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getDefaultFontSize()
chrome.fontSettings.getDefaultFontSize(
details?: object,
callback?: function,
)
Pobiera domyślny rozmiar czcionki.
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
Akcje powrotne
-
Promise<object>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getFont()
chrome.fontSettings.getFont(
details: object,
callback?: function,
)
Pobiera czcionkę dla danego skryptu i ogólnej rodziny czcionek.
Parametry
-
szczegóły
obiekt
-
genericFamily
Ogólna rodzina czcionek, dla której ma zostać pobrana czcionka.
-
pismo
Opcjonalny ScriptCode
Skrypt, dla którego należy pobrać czcionkę. Jeśli zostanie pominięte, zostanie pobrane ustawienie czcionki dla skryptu globalnego (kod skryptu „Zyyy”).
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
fontId
string,
Identyfikator czcionki. Może to być identyfikator czcionki, na którą system określa wartość preferencji, a nie jej literałową wartość. Dlatego
fontId
może się różnić od czcionki przekazanej dosetFont
, jeśli na przykład czcionka nie jest dostępna w systemie. Pusty ciąg oznacza wartość zastępczą dla globalnego ustawienia czcionki skryptu. -
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
-
Akcje powrotne
-
Promise<object>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getFontList()
chrome.fontSettings.getFontList(
callback?: function,
)
Pobiera listę czcionek w systemie.
Parametry
Akcje powrotne
-
Promise<FontName[]>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getMinimumFontSize()
chrome.fontSettings.getMinimumFontSize(
details?: object,
callback?: function,
)
Pobiera minimalny rozmiar czcionki.
Parametry
-
szczegóły
obiekt opcjonalnie
Ten parametr nie jest obecnie używany.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
Akcje powrotne
-
Promise<object>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setDefaultFixedFontSize()
chrome.fontSettings.setDefaultFixedFontSize(
details: object,
callback?: function,
)
Ustawia domyślny rozmiar czcionek o stałej szerokości.
Parametry
-
szczegóły
obiekt
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setDefaultFontSize()
chrome.fontSettings.setDefaultFontSize(
details: object,
callback?: function,
)
Ustawia domyślny rozmiar czcionki.
Parametry
-
szczegóły
obiekt
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setFont()
chrome.fontSettings.setFont(
details: object,
callback?: function,
)
Ustawia czcionkę dla danego skryptu i ogólnej rodziny czcionek.
Parametry
-
szczegóły
obiekt
-
fontId
string,
Identyfikator czcionki. Pusty ciąg oznacza zastępczą zmianę globalnego ustawienia czcionki skryptu.
-
genericFamily
Ogólna rodzina czcionek, dla której ma zostać ustawiona czcionka.
-
pismo
Opcjonalny ScriptCode
Kod skryptu, w którym należy ustawić czcionkę. Jeśli ten argument zostanie pominięty, ustawienie czcionki dla skryptu globalnego (kod skryptu „Zyyy”) zostanie ustawione.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
setMinimumFontSize()
chrome.fontSettings.setMinimumFontSize(
details: object,
callback?: function,
)
Ustawia minimalny rozmiar czcionki.
Parametry
-
szczegóły
obiekt
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
Promise<void>
Chrome 96 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
Wydarzenia
onDefaultFixedFontSizeChanged
chrome.fontSettings.onDefaultFixedFontSizeChanged.addListener(
callback: function,
)
Uruchamiane po zmianie ustawienia domyślnego stałego rozmiaru czcionki.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
onDefaultFontSizeChanged
chrome.fontSettings.onDefaultFontSizeChanged.addListener(
callback: function,
)
Uruchamiane po zmianie domyślnego ustawienia rozmiaru czcionki.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-
onFontChanged
chrome.fontSettings.onFontChanged.addListener(
callback: function,
)
Uruchamiane po zmianie ustawienia czcionki.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
fontId
string,
Identyfikator czcionki. Zobacz opis na
getFont
. -
genericFamily
Ogólna rodzina czcionek, której ustawienie czcionki zostało zmienione.
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pismo
Opcjonalny ScriptCode
Kod skryptu, którego ustawienie czcionki zostało zmienione.
-
-
onMinimumFontSizeChanged
chrome.fontSettings.onMinimumFontSizeChanged.addListener(
callback: function,
)
Uruchamiane po zmianie ustawienia minimalnego rozmiaru czcionki.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(details: object) => void
-
szczegóły
obiekt
-
levelOfControl
Poziom kontroli nad ustawieniem przez to rozszerzenie.
-
pixelSize
Liczba
Rozmiar czcionki w pikselach.
-
-