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

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

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

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

    нить

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

  • идентификатор шрифта

    нить

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

GenericFamily

Общее семейство шрифтов CSS.

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

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

"без засечек"

"засечка"

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

"курсив"

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

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

LevelOfControl

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

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

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

"контролируется_другими_расширениями"

"controllable_by_this_extension"

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

ScriptCode

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

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

"Афак"

«Араб»

"Арми"

"Армн"

"Авст"

«Бали»

"Баму"

"Бас"

"Батьк"

"Бенг"

"Блис"

"Бопо"

"Бра"

"Брэй"

"Буги"

"Буд"

"Чакм"

«Банки»

"Кари"

"Чам"

"Шер"

"Цирт"

«Копт»

"Кпрт"

"Цирл"

"Сирс"

"Дева"

"Дсрт"

"Дупл"

«Егид»

"Егых"

«Египет»

"Эльба"

"Эти"

"Геор"

"Гек"

«Глаг»

"Гот"

"Гран"

"Грек"

"Гуджр"

"Гуру"

"Вешать"

"Хани"

"Хано"

"Ганс"

"Хант"

"Иврит"

"Хлув"

"Хмм"

"Хунг"

"Индс"

"Итал"

"Ява"

"Япония"

"Юрк"

"Кали"

"Хар"

"Хмр"

"Ходж"

"Кнда"

"Кпел"

"Кти"

"Лана"

"Лаоо"

"Латф"

"Латг"

"Латн"

"Лепц"

"Конечность"

"Лина"

"Линб"

"Лису"

"Лома"

"Личи"

"Лиди"

"Манд"

"Мани"

"Майя"

"Исправить"

"Мерс"

"Меро"

"Млим"

"Луна"

"Монг"

"Мру"

"Мтей"

"Мумр"

"Нарб"

"Нбат"

"Нкгб"

"Нку"

"Ншу"

"Огам"

"Олк"

"Орх"

"Оря"

"Осма"

"Ладонь"

«Пермь»

"Фаг"

"Фли"

"Флп"

"Флв"

"Фнкс"

"Плрд"

"Прти"

"Рджнг"

"Роро"

"Беги"

"Самр"

"Сара"

"Сарб"

"Саур"

"Сгнв"

"Шоу"

"Шрд"

"Синд"

"Синх"

"Сора"

"Сунд"

"Сило"

"Сырк"

"Сыр"

"Сырдж"

"Сырн"

"Тагб"

"Такр"

"Сказка"

"Талу"

"Тамл"

"Тан"

"Тавт"

"Телу"

"Тэн"

"Тфнг"

"Тглг"

"Таа"

"Тайский"

"Тибт"

"Тирх"

"Угар"

"Ваи"

"Висп"

"Вара"

"Воле"

"Эксео"

"Ксукс"

"Йиии"

"Змт"

"Зым"

"Зыыы"

Методы

clearDefaultFixedFontSize()

Обещать
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

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

Параметры

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

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

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

clearDefaultFontSize()

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

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

Параметры

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

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

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

clearFont()

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

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

Параметры

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

    объект

    • родовойСемейный

      ОбщийСемейный

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

    • сценарий

      Код сценария необязательно

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

clearMinimumFontSize()

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

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

Параметры

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

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

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

getDefaultFixedFontSize()

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

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

Параметры

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

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

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

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

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

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

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

getDefaultFontSize()

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

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

Параметры

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

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

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

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

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

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

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

getFont()

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

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

Параметры

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

    объект

    • родовойСемейный

      ОбщийСемейный

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

    • сценарий

      Код сценария необязательно

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

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

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

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

    (details: object) => void

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

      объект

      • идентификатор шрифта

        нить

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

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

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

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

Возврат

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

    Хром 96+

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

getFontList()

Обещать
chrome.fontSettings.getFontList(
  callback?: function,
)

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

Параметры

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

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

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

    (results: FontName[]) => void

Возврат

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

    Хром 96+

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

getMinimumFontSize()

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

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

Параметры

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

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

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

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

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

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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

Возврат

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

    Хром 96+

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

setDefaultFixedFontSize()

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

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

Параметры

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

    объект

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

      число

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

setDefaultFontSize()

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

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

Параметры

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

    объект

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

      число

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

setFont()

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

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

Параметры

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

    объект

    • идентификатор шрифта

      нить

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

    • родовойСемейный

      ОбщийСемейный

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

    • сценарий

      Код сценария необязательно

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

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

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

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

    () => void

Возврат

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

    Хром 96+

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

setMinimumFontSize()

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

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

Параметры

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

    объект

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

      число

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

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

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

    Параметр 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

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

      объект

      • идентификатор шрифта

        нить

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

      • родовойСемейный

        ОбщийСемейный

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

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

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

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

      • сценарий

        Код сценария необязательно

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

onMinimumFontSizeChanged

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

Вызывается при изменении настройки минимального размера шрифта.

Параметры

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

    функция

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

    (details: object) => void

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

      объект

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

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

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

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

        число

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