chrome.fontSettings

Описание

Используйте API chrome.fontSettings для управления настройками шрифтов Chrome.

Разрешения

fontSettings

Чтобы использовать API настроек шрифтов, необходимо объявить разрешение "fontSettings" в манифесте расширения . Например:

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

Концепции и использование

Chrome позволяет некоторым настройкам шрифтов зависеть от определённых семейств шрифтов и языковых систем. Например, шрифт, используемый для упрощённого китайского языка без засечек, может отличаться от шрифта, используемого для японского языка с засечками.

Семейства шрифтов, поддерживаемые Chrome, основаны на семействах шрифтов CSS и перечислены в GenericReference . Если на веб-странице указано семейство шрифтов, Chrome выбирает его на основе соответствующих настроек. Если семейство шрифтов не указано, Chrome использует настройки «стандартного» семейства шрифтов.

Если на веб-странице указан язык, Chrome выбирает шрифт на основе настроек соответствующего языкового алфавита. Если язык не указан, Chrome использует настройки шрифта по умолчанию (глобального алфавита).

Поддерживаемые языковые системы письма определяются кодом системы письма ISO 15924 и перечислены в разделе ScriptCode . Технически настройки Chrome не привязаны к конкретной системе письма, а зависят от языка. Например, Chrome выбирает шрифт для кириллицы (код системы письма ISO 15924 «Cyrl»), когда на веб-странице указан русский язык, и использует этот шрифт не только для кириллицы, но и для всех символов, которые поддерживает этот шрифт, например, для латиницы.

Примеры

Следующий код получает стандартный шрифт для арабского языка.

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

Следующий фрагмент устанавливает шрифт без засечек для японского языка.

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

Чтобы опробовать этот API, установите пример API fontSettings из репозитория chrome-extension-samples .

Типы

FontName

Представляет название шрифта.

Характеристики

  • отображаемое имя

    нить

    Отображаемое имя шрифта.

  • fontId

    нить

    Идентификатор шрифта.

GenericFamily

Универсальное семейство шрифтов CSS.

Перечисление

"стандартный"

"sansserif"

"засечки"

"зафиксированный"

"курсив"

"фантастика"

"математика"

LevelOfControl

Один из not\_controllable : не может управляться никаким расширением controlled\_by\_other\_extensions : управляется расширениями с более высоким приоритетом controllable\_by\_this\_extension : может управляться этим расширением controlled\_by\_this\_extension : управляется этим расширением

Перечисление

"не_контролируемый"

"controlled_by_other_extensions"

"контролируемое_этим_расширением"

"controlled_by_this_extension"

ScriptCode

Код сценария ISO 15924. Сценарий по умолчанию, или глобальный, представлен кодом сценария «Zyyy».

Перечисление

"Афак"

«Араб»

"Арми"

"Армн"

"Авст"

"Бали"

"Баму"

"Бас"

"Батьк"

"Бэнг"

"Блис"

"Бопо"

"Бра"

"Брай"

"Буги"

"Buhd"

"Какм"

"Баночки"

"Кари"

"Чам"

"Шер"

"Цирт"

«Копт»

"Кпрт"

"Цирл"

"Сирс"

«Дева»

"Дсрт"

"Дупл"

"Егид"

"Егых"

"Египет"

"Эльба"

"Эти"

"Геор"

"Геок"

"Глаг"

"Гот"

"Бабушка"

"Грек"

"Гуджр"

"Гуру"

"Вешать"

"Хани"

"Хано"

"Ганс"

"Хант"

"Евр."

"Хлув"

"Хмнг"

"Хунг"

"Инди"

"Итал"

«Ява»

"Япония"

"Jurc"

"Кали"

"Хар"

"Кхмр"

"Ходж"

"Кнда"

"Кпел"

"Кти"

"Лана"

"Лау"

"Латф"

"Латг"

"Латн"

"Лепц"

«Конечность»

"Лина"

"Линб"

"Лису"

"Лома"

"Личи"

"Лиди"

"Манд"

"Мани"

"Майя"

"Починить"

"Мерс"

"Меро"

"Млим"

"Луна"

"Монг"

"Мру"

"Мтей"

"Мымр"

"Нарб"

"Нбат"

"НКГБ"

"Нкоо"

"Ншу"

"Огам"

"Ольк"

"Орх"

"Орья"

"Осма"

"Ладонь"

"Пермь"

"Фаг"

"Фли"

"Флп"

"Флв"

"Фнкс"

"Плрд"

"Прти"

"Rjng"

"Роро"

"Runr"

"Самр"

"Сара"

"Сарб"

"Саур"

"Sgnw"

"Шоу"

"Шрд"

"Синд"

"Синх"

"Сора"

"Зунд"

"Сило"

"Сирк"

"Сыре"

"Сырдж"

"Сирн"

"Тэгб"

"Такр"

«Сказка»

"Талу"

"Тамл"

"Тан"

"Тавт"

"Телу"

"Тэн"

"Тфнг"

"Тглг"

"Тхаа"

"Тайский"

"Тибт"

"Тирх"

"Угар"

"Вайи"

"Висп"

"Вара"

"Wole"

"Xpeo"

"Xsux"

"Йиии"

"Змт"

"Зсым"

"Зыыы"

Методы

clearDefaultFixedFontSize()

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

Очищает фиксированный размер шрифта по умолчанию, установленный этим расширением, если таковой имеется.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<void>

    Хром 96+

clearDefaultFontSize()

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

Очищает размер шрифта по умолчанию, установленный этим расширением, если таковой имеется.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<void>

    Хром 96+

clearFont()

chrome.fontSettings.clearFont(
  details: object,
): Promise<void>

Очищает шрифт, установленный этим расширением, если таковой имеется.

Параметры

  • подробности

    объект

    • общийСемейный

      GenericFamily

      Общее семейство шрифтов, для которого следует очистить шрифт.

    • сценарий

      ScriptCode необязательно

      Шрифт, для которого необходимо очистить шрифт. Если параметр не указан, очищается глобальная настройка шрифта.

Возврат

  • Обещание<void>

    Хром 96+

clearMinimumFontSize()

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

Очищает минимальный размер шрифта, установленный этим расширением, если таковой имеется.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<void>

    Хром 96+

getDefaultFixedFontSize()

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

Получает размер по умолчанию для шрифтов фиксированной ширины.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<объект>

    Хром 96+

getDefaultFontSize()

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

Получает размер шрифта по умолчанию.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<объект>

    Хром 96+

getFont()

chrome.fontSettings.getFont(
  details: object,
): Promise<object>

Получает шрифт для заданного сценария и общего семейства шрифтов.

Параметры

  • подробности

    объект

    • общийСемейный

      GenericFamily

      Общее семейство шрифтов, для которого следует получить шрифт.

    • сценарий

      ScriptCode необязательно

      Шрифт, для которого необходимо получить шрифт. Если параметр не указан, будут получены настройки шрифта для глобального шрифта (код шрифта «Zyyy»).

Возврат

  • Обещание<объект>

    Хром 96+

getFontList()

chrome.fontSettings.getFontList(): Promise<FontName[]>

Получает список шрифтов в системе.

Возврат

getMinimumFontSize()

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

Получает минимальный размер шрифта.

Параметры

  • подробности

    объект необязательный

    Этот параметр в настоящее время не используется.

Возврат

  • Обещание<объект>

    Хром 96+

setDefaultFixedFontSize()

chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
): Promise<void>

Устанавливает размер по умолчанию для шрифтов фиксированной ширины.

Параметры

  • подробности

    объект

    • размер пикселя

      число

      Размер шрифта в пикселях.

Возврат

  • Обещание<void>

    Хром 96+

setDefaultFontSize()

chrome.fontSettings.setDefaultFontSize(
  details: object,
): Promise<void>

Устанавливает размер шрифта по умолчанию.

Параметры

  • подробности

    объект

    • размер пикселя

      число

      Размер шрифта в пикселях.

Возврат

  • Обещание<void>

    Хром 96+

setFont()

chrome.fontSettings.setFont(
  details: object,
): Promise<void>

Устанавливает шрифт для заданного сценария и общего семейства шрифтов.

Параметры

  • подробности

    объект

    • fontId

      нить

      Идентификатор шрифта. Пустая строка означает возврат к глобальным настройкам шрифта.

    • общийСемейный

      GenericFamily

      Общее семейство шрифтов, для которого следует установить шрифт.

    • сценарий

      ScriptCode необязательно

      Код скрипта, для которого следует установить шрифт. Если не указан, устанавливается настройка шрифта для глобального скрипта (код скрипта «Zyyy»).

Возврат

  • Обещание<void>

    Хром 96+

setMinimumFontSize()

chrome.fontSettings.setMinimumFontSize(
  details: object,
): Promise<void>

Устанавливает минимальный размер шрифта.

Параметры

  • подробности

    объект

    • размер пикселя

      число

      Размер шрифта в пикселях.

Возврат

  • Обещание<void>

    Хром 96+

События

onDefaultFixedFontSizeChanged

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

Срабатывает при изменении настройки фиксированного размера шрифта по умолчанию.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (details: object) => void

    • подробности

      объект

      • уровень контроля

        УровеньКонтроля

        Уровень контроля этого расширения над настройкой.

      • размер пикселя

        число

        Размер шрифта в пикселях.

onDefaultFontSizeChanged

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

Срабатывает при изменении настройки размера шрифта по умолчанию.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (details: object) => void

    • подробности

      объект

      • уровень контроля

        УровеньКонтроля

        Уровень контроля этого расширения над настройкой.

      • размер пикселя

        число

        Размер шрифта в пикселях.

onFontChanged

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

Срабатывает при изменении настроек шрифта.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (details: object) => void

    • подробности

      объект

      • fontId

        нить

        Идентификатор шрифта. См. описание в getFont .

      • общийСемейный

        GenericFamily

        Универсальное семейство шрифтов, для которого были изменены настройки шрифта.

      • уровень контроля

        УровеньКонтроля

        Уровень контроля этого расширения над настройкой.

      • сценарий

        ScriptCode необязательно

        Код скрипта, для которого изменились настройки шрифта.

onMinimumFontSizeChanged

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

Срабатывает при изменении минимального размера шрифта.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (details: object) => void

    • подробности

      объект

      • уровень контроля

        УровеньКонтроля

        Уровень контроля этого расширения над настройкой.

      • размер пикселя

        число

        Размер шрифта в пикселях.