chrome.fontSettings

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 być inna niż czcionka używana 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ższym opisie interfejsu API. Gdy strona określa ogólną rodzinę czcionek, Chrome wybiera czcionkę na podstawie odpowiedniego ustawienia. Jeśli nie określono żadnej 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 alfabety są określone przez kod alfabetu ISO 15924 i wymienione w dokumentacji 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. liter ł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); }
);

Kolejny 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

    ciąg znaków

    Wyświetlana nazwa czcionki.

  • fontId

    ciąg znaków

    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żna sterować za pomocą żadnego rozszerzeniacontrolled\_by\_other\_extensions: sterowane przez rozszerzenia o wyższym prioryteciecontrollable\_by\_this\_extension: można sterować za pomocą tego rozszerzeniacontrolled\_by\_this\_extension: sterowane 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”

„Puszki”

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

„Kończyna”

„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 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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 ma zostać usunięta.

    • pismo

      ScriptCode opcjonalny

      Skrypt, dla którego należy usunąć czcionkę. W przypadku pominięcia tej informacji globalne ustawienie czcionki skryptu zostanie wyczyszczone.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 należy pobrać czcionkę. 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

        ciąg znaków

        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 takim przypadku wartość fontId może się różnić od czcionki przekazanej do 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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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

      ciąg znaków

      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 ta informacja zostanie pominięta, zostanie ustawiona czcionka dla skryptu globalnego (kod skryptu „Zyyy”).

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome w wersji 96 lub nowszej

    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 w wersji 96 lub nowszej

    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,
)

Wyzwalane, 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,
)

Wysyłane, 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,
)

Wyzwalane, gdy zmieni się ustawienie czcionki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • fontId

        ciąg znaków

        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.