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에서는 일부 글꼴 설정이 특정 일반 글꼴 모음 및 언어 스크립트에 종속될 수 있습니다. 예를 들어 sans-serif 중국어 간체에 사용되는 글꼴은 serif 일본어에 사용되는 글꼴과 다를 수 있습니다.

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); }
);

다음 스니펫은 일본어의 sans-serif 글꼴을 설정합니다.

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

이 API를 사용해 보려면 chrome-extension-samples 저장소에서 fontSettings API 예시를 설치합니다.

유형

FontName

글꼴 이름을 나타냅니다.

속성

  • displayName

    문자열

    글꼴의 표시 이름입니다.

  • fontId

    문자열

    글꼴 ID입니다.

GenericFamily

CSS 일반 글꼴 모음입니다.

열거형

'표준'

"sansserif"

"serif"

'해결됨'

'cursive'

'fantasy'

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

'엘바'

"Ethi"

'Geor'

'Geok'

"Glag"

'Goth'

"Gran"

"Grek"

"Gujr"

'Guru'

'중단'

"한이"

"Hano"

"한스"

'Hant'

"Hebr"

"Hluw"

"Hmng"

"Hung"

'Inds'

'Ital'

'Java'

"Jpan"

"Jurc"

"Kali"

"Khar"

'Khmr'

"Khoj"

"Knda"

"Kpel"

"Kthi"

'라나'

'라오어'

"Latf"

"Latg"

'Latn'

'Lepc'

'Limb'

"리나"

"Linb"

"Lisu"

'Loma'

"Lyci"

"Lydi"

'Mand'

'Mani'

'Maya'

'수리'

'Merc'

'Mero'

"Mlym"

'달'

"Mong"

'Mroo'

'Mtei'

'Mymr'

'Narb'

"Nbat"

"Nkgb"

'Nkoo'

"Nshu"

'Ogam'

"Olck"

'Orkh'

'Orya'

"Osma"

'손바닥'

'Perm'

'Phag'

'Phli'

"Phlp"

'Phlv'

"Phnx"

'Plrd'

'Prti'

"Rjng"

"Roro"

'Runr'

'Samr'

'사라'

'Sarb'

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

'Sinh'

"소라"

"Sund"

'Sylo'

'Syrc'

'Syre'

'Syrj'

'Syrn'

"Tagb"

'Takr'

'Tale'

"Talu"

"Taml"

"Tang"

'Tavt'

'Telu'

'Teng'

"Tfng"

"Tglg"

"Thaa"

'태국어'

"Tibt"

'Tirh'

"Ugar"

"Vaii"

'Visp'

'Wara'

"Wole"

'Xpeo'

'Xsux'

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

메서드

clearDefaultFixedFontSize()

Promise 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearDefaultFontSize()

Promise 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearFont()

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

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

매개변수

  • 세부정보

    객체

    • genericFamily

      GenericFamily

      글꼴을 지워야 하는 일반 글꼴 모음입니다.

    • 스크립트

      ScriptCode 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearMinimumFontSize()

Promise 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getDefaultFixedFontSize()

Promise 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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

반환 값

  • Promise<object>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getDefaultFontSize()

Promise 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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

반환 값

  • Promise<object>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getFont()

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

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

매개변수

  • 세부정보

    객체

    • genericFamily

      GenericFamily

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

    • 스크립트

      ScriptCode 선택사항

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

  • 콜백

    함수 선택사항

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

    (details: object) => void

    • 세부정보

      객체

      • fontId

        문자열

        글꼴 ID입니다. 이는 글꼴 ID 기본 설정 값이 아니라 시스템에서 기본 설정 값을 확인하는 글꼴의 ID일 수 있습니다. 따라서 fontId는 setFont에 전달된 글꼴과 다를 수 있습니다(예: 시스템에서 글꼴을 사용할 수 없는 경우). 빈 문자열은 전역 스크립트 글꼴 설정으로 대체됨을 나타냅니다.

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

반환 값

  • Promise<object>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getFontList()

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

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

매개변수

  • 콜백

    함수 선택사항

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

    (results: FontName[]) => void

반환 값

  • Promise<FontName[]>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getMinimumFontSize()

Promise 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체 선택사항

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

  • 콜백

    함수 선택사항

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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

반환 값

  • Promise<object>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setDefaultFixedFontSize()

Promise 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setDefaultFontSize()

Promise 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setFont()

Promise 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체

    • fontId

      문자열

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

    • genericFamily

      GenericFamily

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

    • 스크립트

      ScriptCode 선택사항

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setMinimumFontSize()

Promise 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체

    • pixelSize

      숫자

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 96 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onDefaultFixedFontSizeChanged

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

기본 고정 글꼴 크기 설정이 변경될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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

onDefaultFontSizeChanged

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

기본 글꼴 크기 설정이 변경될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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

onFontChanged

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

글꼴 설정이 변경될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (details: object) => void

    • 세부정보

      객체

      • fontId

        문자열

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

      • genericFamily

        GenericFamily

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

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • 스크립트

        ScriptCode 선택사항

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

onMinimumFontSizeChanged

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

최소 글꼴 크기 설정이 변경될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (details: object) => void

    • 세부정보

      객체

      • levelOfControl

        LevelOfControl

        이 확장 프로그램이 설정을 제어할 수 있는 수준입니다.

      • pixelSize

        숫자

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