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 и перечислены в справочнике API ниже. Если на веб-странице указано семейство шрифтов, Chrome выбирает шрифт на основе соответствующих настроек. Если семейство шрифтов не указано, Chrome использует настройки «стандартного» семейства шрифтов.

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

Поддерживаемые языковые системы письма определены кодом ISO 15924 и перечислены в справке по API ниже. Технически настройки 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,
  callback?: function,
): Promise<void>

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

Параметры

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

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

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

clearDefaultFontSize()

Обещать
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<void>

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

Параметры

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

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

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

clearFont()

Обещать
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
): Promise<void>

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

Параметры

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

    объект

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

      GenericFamily

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

    • сценарий

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

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

clearMinimumFontSize()

Обещать
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<void>

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

Параметры

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

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

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getDefaultFixedFontSize()

Обещать
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<object>

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

Параметры

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

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

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

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

    функция необязательна

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getDefaultFontSize()

Обещать
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<object>

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

Параметры

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

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

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

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

    функция необязательна

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getFont()

Обещать
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
): Promise<object>

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

Параметры

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

    объект

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

      GenericFamily

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

    • сценарий

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

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

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

    функция необязательна

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

    (details: object) => void

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

      объект

      • fontId

        нить

        Идентификатор шрифта. Вместо буквального значения параметра идентификатора шрифта это может быть идентификатор шрифта, по которому система определяет значение параметра. Таким образом, fontId может отличаться от шрифта, переданного в setFont , например, если шрифт недоступен в системе. Пустая строка означает откат к глобальной настройке шрифта.

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

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

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

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getFontList()

Обещать
chrome.fontSettings.getFontList(
  callback?: function,
): Promise<FontName[]>

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

Параметры

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

    функция необязательна

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

    (results: FontName[]) => void

Возврат

  • Обещание< ИмяШрифта []>

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getMinimumFontSize()

Обещать
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<object>

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

Параметры

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

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

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

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

    функция необязательна

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setDefaultFixedFontSize()

Обещать
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
): Promise<void>

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

Параметры

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

    объект

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

      число

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setDefaultFontSize()

Обещать
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
): Promise<void>

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

Параметры

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

    объект

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

      число

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setFont()

Обещать
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
): Promise<void>

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

Параметры

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

    объект

    • fontId

      нить

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

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

      GenericFamily

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

    • сценарий

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

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

setMinimumFontSize()

Обещать
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
): Promise<void>

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

Параметры

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

    объект

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

      число

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

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

    функция необязательна

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

    () => void

Возврат

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

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

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

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

      объект

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

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

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

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

        число

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