chrome.fontSettings

설명

chrome.fontSettings API를 사용하여 Chrome의 글꼴 설정을 관리합니다.

권한

fontSettings

Font Settings API를 사용하려면 확장 프로그램 매니페스트에서 "fontSettings" 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

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

개념 및 사용

Chrome에서는 특정 일반 글꼴 모음과 언어 스크립트에 따라 일부 글꼴 설정을 사용할 수 있습니다. 예를 들어 산세리프 중국어(간체)에 사용되는 글꼴은 세리프 일본어에 사용되는 글꼴과 다를 수 있습니다.

Chrome에서 지원하는 일반 글꼴 모음은 CSS 일반 글꼴 모음을 기반으로 하며 GenericReference에 나열되어 있습니다. 웹페이지에서 일반 글꼴 모음을 지정하면 Chrome은 해당 설정을 기반으로 글꼴을 선택합니다. 일반 글꼴 모음이 지정되지 않으면 Chrome은 'standard' 일반 글꼴 모음의 설정을 사용합니다.

웹페이지에서 언어를 지정하면 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를 사용해 보려면 chrome-extension-samples 저장소에서 fontSettings API 예시를 설치하세요.

유형

FontName

글꼴 이름을 나타냅니다.

속성

  • displayName

    문자열

    글꼴의 표시 이름입니다.

  • fontId

    문자열

    글꼴 ID입니다.

GenericFamily

CSS 일반 글꼴 모음입니다.

열거형

'standard'

"sansserif"

"serif"

'fixed'

"cursive"

"판타지"

"math"

LevelOfControl

다음 중 하나입니다. not\_controllable: 확장 프로그램으로 제어할 수 없음 controlled\_by\_other\_extensions: 우선순위가 높은 확장 프로그램으로 제어됨 controllable\_by\_this\_extension: 이 확장 프로그램으로 제어할 수 있음 controlled\_by\_this\_extension: 이 확장 프로그램으로 제어됨

열거형

'not_controllable'

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

ISO 15924 스크립트 코드입니다. 기본 또는 전역 스크립트는 스크립트 코드 'Zyyy'로 표시됩니다.

열거형

'Afak'

'아랍어'

"Armi"

"Armn"

'Avst'

"Bali"

"Bamu"

'베이스'

"Batk"

"Beng"

'Blis'

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

'Cakm'

'캔'

"Cari"

"Cham"

'Cher'

"Cirt"

'Copt'

"Cprt"

"Cyrl"

'Cyrs'

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

'Elba'

"Ethi"

"Geor"

'Geok'

"Glag"

'고스'

'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"

'Limb'

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

'Mani'

'Maya'

'수리'

'Merc'

"Mero"

"Mlym"

"Moon"

"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"

메서드

clearDefaultFixedFontSize()

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

이 확장 프로그램에서 설정한 기본 고정 글꼴 크기를 삭제합니다(있는 경우).

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<void>

    Chrome 96 이상

clearDefaultFontSize()

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

이 확장 프로그램에서 설정한 기본 글꼴 크기를 지웁니다(있는 경우).

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<void>

    Chrome 96 이상

clearFont()

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

이 확장 프로그램에서 설정한 글꼴을 지웁니다(있는 경우).

매개변수

  • 세부정보

    객체

    • genericFamily

      GenericFamily

      글꼴을 삭제해야 하는 일반 글꼴 모음입니다.

    • 스크립트

      ScriptCode 선택사항

      글꼴을 지워야 하는 스크립트입니다. 생략하면 전역 스크립트 글꼴 설정이 지워집니다.

반환 값

  • Promise<void>

    Chrome 96 이상

clearMinimumFontSize()

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

이 확장 프로그램에서 설정한 최소 글꼴 크기를 지웁니다(있는 경우).

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<void>

    Chrome 96 이상

getDefaultFixedFontSize()

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

고정 너비 글꼴의 기본 크기를 가져옵니다.

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<object>

    Chrome 96 이상

getDefaultFontSize()

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

기본 글꼴 크기를 가져옵니다.

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<object>

    Chrome 96 이상

getFont()

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

지정된 스크립트와 일반 글꼴 모음의 글꼴을 가져옵니다.

매개변수

  • 세부정보

    객체

    • genericFamily

      GenericFamily

      글꼴을 가져와야 하는 일반 글꼴 모음입니다.

    • 스크립트

      ScriptCode 선택사항

      글꼴을 가져와야 하는 스크립트입니다. 생략하면 전역 스크립트 (스크립트 코드 'Zyyy')의 글꼴 설정이 검색됩니다.

반환 값

  • Promise<object>

    Chrome 96 이상

getFontList()

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

시스템의 글꼴 목록을 가져옵니다.

반환 값

getMinimumFontSize()

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

최소 글꼴 크기를 가져옵니다.

매개변수

  • 세부정보

    객체 선택사항

    이 매개변수는 현재 사용되지 않습니다.

반환 값

  • Promise<object>

    Chrome 96 이상

setDefaultFixedFontSize()

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

고정 너비 글꼴의 기본 크기를 설정합니다.

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

      글꼴 크기(픽셀)입니다.

반환 값

  • Promise<void>

    Chrome 96 이상

setDefaultFontSize()

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

기본 글꼴 크기를 설정합니다.

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

      글꼴 크기(픽셀)입니다.

반환 값

  • Promise<void>

    Chrome 96 이상

setFont()

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

지정된 스크립트와 일반 글꼴 모음의 글꼴을 설정합니다.

매개변수

  • 세부정보

    객체

    • fontId

      문자열

      글꼴 ID입니다. 빈 문자열은 전역 스크립트 글꼴 설정으로 대체됨을 의미합니다.

    • genericFamily

      GenericFamily

      글꼴을 설정해야 하는 일반 글꼴 모음입니다.

    • 스크립트

      ScriptCode 선택사항

      글꼴을 설정해야 하는 스크립트 코드입니다. 생략하면 전역 스크립트 (스크립트 코드 'Zyyy')의 글꼴 설정이 설정됩니다.

반환 값

  • Promise<void>

    Chrome 96 이상

setMinimumFontSize()

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

최소 글꼴 크기를 설정합니다.

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

      글꼴 크기(픽셀)입니다.

반환 값

  • Promise<void>

    Chrome 96 이상

이벤트

onDefaultFixedFontSizeChanged

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

기본 고정 글꼴 크기 설정이 변경될 때 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정에 대해 갖는 제어 수준입니다.

      • pixelSize

        숫자

        글꼴 크기(픽셀)입니다.

onDefaultFontSizeChanged

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

기본 글꼴 크기 설정이 변경될 때 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정에 대해 갖는 제어 수준입니다.

      • pixelSize

        숫자

        글꼴 크기(픽셀)입니다.

onFontChanged

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

글꼴 설정이 변경될 때 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (details: object) => void

    • 세부정보

      객체

      • fontId

        문자열

        글꼴 ID입니다. getFont의 설명을 참고하세요.

      • genericFamily

        GenericFamily

        글꼴 설정이 변경된 일반 글꼴 모음입니다.

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정에 대해 갖는 제어 수준입니다.

      • 스크립트

        ScriptCode 선택사항

        글꼴 설정이 변경된 스크립트 코드입니다.

onMinimumFontSizeChanged

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

최소 글꼴 크기 설정이 변경될 때 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정에 대해 갖는 제어 수준입니다.

      • pixelSize

        숫자

        글꼴 크기(픽셀)입니다.