chrome.fontSettings

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.fontSettings, 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 bezszeryfowego uproszczonego chińskiego może być inna niż czcionka używana w przypadku szeryfowego japońskiego.

Ogólne rodziny czcionek obsługiwane przez Chrome są oparte na ogólnych rodzinach czcionek CSS i są wymienione w dokumentacji API poniżej. Gdy strona internetowa 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 internetowa 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 alfabety są określone przez kod alfabetu ISO 15924 i wymienione w dokumentacji API poniżej. Technicznie rzecz biorąc, ustawienia Chrome nie są ściśle powiązane z pismem, ale zależą też od języka. Na przykład Chrome wybiera czcionkę dla cyrylicy (kod ISO 15924 „Cyrl”), gdy strona internetowa określa język rosyjski, i używa tej czcionki nie tylko do cyrylicy, ale do wszystkiego, co obejmuje, np. do alfabetu łacińskiego.

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ę Sans Serif 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

Jedna z tych wartości: not\_controllable: nie może być kontrolowane przez żadne rozszerzenie controlled\_by\_other\_extensions: kontrolowane przez rozszerzenia o wyższym priorytecie controllable\_by\_this\_extension: może być kontrolowane przez to rozszerzenie controlled\_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 pisma w formacie ISO 15924. Domyślne lub globalne pismo jest reprezentowane przez kod „Zyyy”.

Typ wyliczeniowy

„Afak”

"Arab"

„Aran”

„Armi”

"Armn"

"Avst"

"Bali"

„Bamu”

„Bas”

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

„Księżyc”

"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 jest ustawiony).

Parametry

  • szczegóły

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

clearFont()

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

Usuwa czcionkę ustawioną przez to rozszerzenie, jeśli jest ustawiona.

Parametry

  • szczegóły

    obiekt

    • genericFamily

      GenericFamily

      Ogólna rodzina czcionek, dla której czcionka powinna zostać wyczyszczona.

    • pismo

      ScriptCode opcjonalny

      Skrypt, dla którego należy usunąć czcionkę. Jeśli pominiesz tę wartość, globalne ustawienie czcionki skryptu zostanie wyczyszczone.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 jest ustawiony).

Parametry

  • szczegóły

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    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 wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getDefaultFontSize()

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

Pobiera domyślny rozmiar czcionki.

Parametry

  • szczegóły

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    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 wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 zostanie pominięty, pobierane jest ustawienie czcionki dla skryptu globalnego (kod skryptu „Zyyy”).

  • callback

    function opcjonalne

    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 przypisuje wartość preferencji. Dlatego fontId może się różnić od czcionki przekazanej do setFont, jeśli na przykład 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 wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getFontList()

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

Pobiera listę czcionek w systemie.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (results: FontName[]) => void

Zwroty

  • Obietnica<FontName[]>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getMinimumFontSize()

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

Pobiera minimalny rozmiar czcionki.

Parametry

  • szczegóły

    object opcjonalny

    Ten parametr nie jest obecnie używany.

  • callback

    function opcjonalne

    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 wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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, że zostanie użyte ustawienie globalne czcionki skryptu.

    • genericFamily

      GenericFamily

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

    • pismo

      ScriptCode opcjonalny

      Kod skryptu, dla którego należy ustawić czcionkę. Jeśli go pominiesz, zostanie ustawione ustawienie czcionki dla skryptu globalnego (kod skryptu „Zyyy”).

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onDefaultFixedFontSizeChanged

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

Uruchamiane, gdy zmienia 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,
)

Uruchamiane, gdy zmienia się domyślne ustawienie 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.

onFontChanged

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

Uruchamiane, gdy zmieni się ustawienie czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • fontId

        tekst

        Identyfikator czcionki. Zobacz opis 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,
)

Uruchamiane, gdy zmienia 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.