chrome.fontSettings

Opis

Do zarządzania ustawieniami czcionek Chrome używaj interfejsu API chrome.fontSettings.

Uprawnienia

fontSettings

Aby korzystać z interfejsu Font Settings API, musisz w manifeście rozszerzenia zadeklarować uprawnienie "fontSettings". Na przykład:

{
  "name": "My Font Settings Extension",
  "description": "Customize your fonts",
  "version": "0.2",
  "permissions": [
    "fontSettings"
  ],
  ...
}

Pojęcia i zastosowanie

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 sekcji GenericReference. 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 internetowej 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 wyświetlane w sekcji ScriptCode. 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()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

clearDefaultFontSize()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

clearFont()

Obietnica 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

Usuwa czcionkę ustawioną przez to rozszerzenie (jeśli istnieje).

Parametry

  • szczegóły

    obiekt

    • genericFamily

      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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

clearMinimumFontSize()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getDefaultFixedFontSize()

Obietnica 
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

        LevelOfControl

        Poziom kontroli nad ustawieniem przez to rozszerzenie.

      • pixelSize

        Liczba

        Rozmiar czcionki w pikselach.

Akcje powrotne

  • Promise<object>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getDefaultFontSize()

Obietnica 
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

        LevelOfControl

        Poziom kontroli nad ustawieniem przez to rozszerzenie.

      • pixelSize

        Liczba

        Rozmiar czcionki w pikselach.

Akcje powrotne

  • Promise<object>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getFont()

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

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

Parametry

  • szczegóły

    obiekt

    • genericFamily

      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 do setFont, 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

        LevelOfControl

        Poziom kontroli nad ustawieniem przez to rozszerzenie.

Akcje powrotne

  • Promise<object>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getFontList()

Obietnica 
chrome.fontSettings.getFontList(
  callback?: function,
)

Pobiera listę czcionek w systemie.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (results: FontName[])=>void

Akcje powrotne

  • Promise<FontName[]>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getMinimumFontSize()

Obietnica 
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

        LevelOfControl

        Poziom kontroli nad ustawieniem przez to rozszerzenie.

      • pixelSize

        Liczba

        Rozmiar czcionki w pikselach.

Akcje powrotne

  • Promise<object>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setDefaultFixedFontSize()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setDefaultFontSize()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setFont()

Obietnica 
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

      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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setMinimumFontSize()

Obietnica 
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 wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

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

        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

        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

        GenericFamily

        Ogólna rodzina czcionek, której ustawienie czcionki zostało zmienione.

      • levelOfControl

        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

        LevelOfControl

        Poziom kontroli nad ustawieniem przez to rozszerzenie.

      • pixelSize

        Liczba

        Rozmiar czcionki w pikselach.