chrome.fontSettings

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu chrome.fontSettings API, aby zarządzać ustawieniami czcionek w Chrome.

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

Chrome umożliwia uzależnienie niektórych ustawień czcionek od określonych ogólnych rodzin czcionek i skryptów językowych. Na przykład czcionka używana w przypadku chińskiego uproszczonego bezszeryfowego może różnić się od czcionki używanej w przypadku japońskiego szeryfowego.

Ogólne rodziny czcionek obsługiwane przez Chrome są oparte na ogólnych rodzinach czcionek CSS i są wymienione w poniższej dokumentacji API. Gdy strona określa ogólną rodzinę czcionek, Chrome wybiera czcionkę na podstawie odpowiedniego ustawienia. Jeśli nie określono ogólnej rodziny czcionek, Chrome używa ustawienia „standardowej” ogólnej rodziny czcionek.

Gdy strona określa język, Chrome wybiera czcionkę na podstawie ustawienia odpowiedniego skryptu językowego. Jeśli nie określono języka, Chrome używa ustawienia domyślnego lub globalnego skryptu.

Obsługiwane skrypty języków są określone przez kod skryptu ISO 15924 i wymienione w dokumentacji interfejsu API poniżej. Technicznie ustawienia Chrome nie są ściśle powiązane ze skryptem, ale zależą też od języka. Na przykład Chrome wybiera czcionkę dla cyrylicy (kod alfabetu ISO 15924 „Cyrl”), gdy strona internetowa określa język rosyjski, i używa tej czcionki nie tylko w przypadku cyrylicy, ale też w przypadku wszystkich znaków, które obejmuje, np. łacińskich.

Przykłady

Poniższy kod pobiera standardową czcionkę dla języka arabskiego.

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

Następny fragment kodu ustawia czcionkę bezszeryfową dla języka japońskiego.

chrome.fontSettings.setFont(
  { genericFamily: 'sansserif', script: 'Jpan', fontId: 'MS PGothic' }
);

Aby wypróbować ten interfejs API, zainstaluj przykład interfejsu fontSettings API z repozytorium chrome-extension-samples.

Typy

FontName

Reprezentuje nazwę czcionki.

Właściwości

  • wyświetlanaNazwa

    tekst

    Wyświetlana nazwa czcionki.

  • fontId

    tekst

    Identyfikator czcionki.

GenericFamily

Ogólna rodzina czcionek CSS.

Typ wyliczeniowy

„standard”

"sansserif"

"serif"

„fixed”

„cursive”

„fantasy”

„math”

LevelOfControl

Jeden z tych stanów:not\_controllable: nie może być kontrolowane przez żadne rozszerzeniecontrolled\_by\_other\_extensions: kontrolowane przez rozszerzenia o wyższym prioryteciecontrollable\_by\_this\_extension: może być kontrolowane przez to rozszerzeniecontrolled\_by\_this\_extension: kontrolowane przez to rozszerzenie

Typ wyliczeniowy

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Kod alfabetu w formacie ISO 15924. Domyślny lub globalny skrypt jest reprezentowany przez kod skryptu „Zyyy”.

Typ wyliczeniowy

„Afak”

„Arab”

„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”

„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”

„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”

Metody

clearDefaultFixedFontSize()

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

Usuwa domyślny stały rozmiar czcionki ustawiony przez to rozszerzenie (jeśli taki istnieje).

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

clearDefaultFontSize()

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

Usuwa domyślny rozmiar czcionki ustawiony przez to rozszerzenie (jeśli taki istnieje).

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

clearFont()

Obietnica 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
): Promise<void>

Usuwa czcionkę ustawioną przez to rozszerzenie, jeśli taka istnieje.

Parametry

  • szczegóły

    obiekt

    • genericFamily

      GenericFamily

      Ogólna rodzina czcionek, z której czcionka powinna zostać usunięta.

    • pismo

      ScriptCode opcjonalny

      Skrypt, dla którego czcionka ma zostać usunięta. Jeśli ten parametr zostanie pominięty, globalne ustawienie czcionki skryptu zostanie wyczyszczone.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

clearMinimumFontSize()

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

Usuwa minimalny rozmiar czcionki ustawiony przez to rozszerzenie (jeśli taki istnieje).

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getDefaultFixedFontSize()

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

Pobiera domyślny rozmiar czcionek o stałej szerokości.

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.

Zwroty

  • Promise<object>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getDefaultFontSize()

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

Pobiera domyślny rozmiar czcionki.

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.

Zwroty

  • Promise<object>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getFont()

Obietnica 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
): Promise<object>

Pobiera czcionkę dla danego skryptu i ogólnej rodziny czcionek.

Parametry

  • szczegóły

    obiekt

    • genericFamily

      GenericFamily

      Ogólna rodzina czcionek, dla której należy pobrać czcionkę.

    • pismo

      ScriptCode opcjonalny

      Skrypt, dla którego ma zostać pobrana czcionka. Jeśli ten parametr zostanie pominięty, pobierane jest ustawienie czcionki dla skryptu globalnego (kod skryptu „Zyyy”).

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • fontId

        tekst

        Identyfikator czcionki. Zamiast dosłownej wartości preferencji identyfikatora czcionki może to być identyfikator czcionki, do której system rozwiązuje wartość preferencji. W związku z tym wartość fontId może się różnić od czcionki przekazanej do funkcji setFont, np. jeśli czcionka nie jest dostępna w systemie. Pusty ciąg znaków oznacza powrót do globalnego ustawienia czcionki skryptu.

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

Zwroty

  • Promise<object>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getFontList()

Obietnica 
chrome.fontSettings.getFontList(
  callback?: function,
): Promise<FontName[]>

Pobiera listę czcionek w systemie.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (results: FontName[]) => void

Zwroty

  • Promise<FontName[]>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getMinimumFontSize()

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

Pobiera minimalny rozmiar czcionki.

Parametry

  • szczegóły

    obiekt opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.

Zwroty

  • Promise<object>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setDefaultFixedFontSize()

Obietnica 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
): Promise<void>

Ustawia domyślny rozmiar czcionek o stałej szerokości.

Parametry

  • szczegóły

    obiekt

    • pixelSize

      liczba

      Rozmiar czcionki w pikselach.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setDefaultFontSize()

Obietnica 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
): Promise<void>

Ustawia domyślny rozmiar czcionki.

Parametry

  • szczegóły

    obiekt

    • pixelSize

      liczba

      Rozmiar czcionki w pikselach.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setFont()

Obietnica 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
): Promise<void>

Ustawia czcionkę dla danego skryptu i ogólnej rodziny czcionek.

Parametry

  • szczegóły

    obiekt

    • fontId

      tekst

      Identyfikator czcionki. Pusty ciąg znaków oznacza powrót do globalnego ustawienia czcionki skryptu.

    • genericFamily

      GenericFamily

      Ogólna rodzina czcionek, dla której ma zostać ustawiona czcionka.

    • pismo

      ScriptCode opcjonalny

      Kod skryptu, dla którego należy ustawić czcionkę. Jeśli ten parametr zostanie pominięty, zostanie ustawiona czcionka dla skryptu globalnego (kod skryptu „Zyyy”).

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

setMinimumFontSize()

Obietnica 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
): Promise<void>

Ustawia minimalny rozmiar czcionki.

Parametry

  • szczegóły

    obiekt

    • pixelSize

      liczba

      Rozmiar czcionki w pikselach.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onDefaultFixedFontSizeChanged

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

Wywoływane, gdy zmieni się domyślne ustawienie stałego rozmiaru czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.

onDefaultFontSizeChanged

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

Wywoływane, gdy zmieni się domyślny rozmiar czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.

onFontChanged

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

Uruchamia się, gdy zmieni się ustawienie czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • fontId

        tekst

        Identyfikator czcionki. Opis znajdziesz w getFont.

      • genericFamily

        GenericFamily

        Ogólna rodzina czcionek, dla której zmieniono ustawienie czcionki.

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pismo

        ScriptCode opcjonalny

        Kod skryptu, dla którego zmieniono ustawienie czcionki.

onMinimumFontSizeChanged

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

Wywoływane, gdy zmieni się ustawienie minimalnego rozmiaru czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • levelOfControl

        LevelOfControl

        Poziom kontroli, jaką rozszerzenie ma nad ustawieniem.

      • pixelSize

        liczba

        Rozmiar czcionki w pikselach.