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은 웹페이지는 러시아어를 지정하며 키릴 문자뿐 아니라 라틴어와 같이 글꼴이 커버하는 모든 텍스트를 포함할 수 있습니다.

예

다음 코드는 아랍어의 표준 글꼴을 가져옵니다.

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"

'판타지'

"수학"

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'

"아랍어"

'아르미'

'무기'

"Avst"

"발리"

'바무'

"베이스"

"바크"

"벵"

'블리스'

'Bopo'

"브라"

"영호"

'부기'

"Buhd"

'Cakm'

"캔"

'영희'

"참"

'쉐어'

"Cirt"

"Copt"

'Cprt'

"Cyrl"

'Cyrs'

'데바'

'Dsrt'

'Dupl'

'에기드'

"에기"

'Egyp'

'엘바'

'에티'

"Geor"

"지오크"

'글래그'

'고스'

"그란"

"그리크"

'Gujr'

"전문가"

"멈춤"

'한나'

"하노"

"한스"

"핸트"

"헤브"

'Hluw'

'Hmng'

"중지됨"

"인수"

"이탈리아어"

'자바'

'일본'

'Jurc'

"칼리"

"카르"

"Khmr"

"호즈"

'Knda'

"Kpel"

'크티'

'라나'

'라우'

'라트프'

'위도'

"위도"

'Lepc'

'수직'

'리나'

'Linb'

'Lisu'

'로마'

'Lyci'

'리디'

"맨드"

'마니'

'마야'

'Mend'

'상품'

'메로'

"Mlym"

"달"

'몽'

"음루"

'Mtei'

"Mymr"

'나브'

'Nbat'

'Nkgb'

'Nkoo'

'Nshu'

'Ogam'

"Olck"

'오르크'

'오리야'

'오스마'

'야자'

"페름"

'파그'

'플리'

"Phlp"

'Phlv'

'Phnx'

'Plrd'

'Prti'

'Rjng'

'로로'

"Runr"

"샘르"

'사라'

'사브'

'사우르'

"Sgnw"

'Shaw'

"샤드"

'Sind'

'싱'

'소라'

"일"

"Sylo"

"Syrc"

"시레"

"시르즈"

"Syrn"

'태그'

"Takr"

'스토리'

'탈루'

"탬플"

"Tang"

"Tavt"

"텔루"

"Teng"

'Tfng'

'Tglg'

'사'

"태국어"

'Tibt'

'티르'

"우가르"

'바이'

"Visp"

'와라'

"Wole"

'Xpeo'

'Xsux'

'Yiii'

'Zmth'

'Zsym'

'Zyyy'

메서드

clearDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearFont()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • genericFamily

    GenericFamily

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

  • 스크립트

    ScriptCode 선택사항

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

clearMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  (details: object) => void

  • 세부정보

    객체

    • levelOfControl

      LevelOfControl

      설정에 대한 이 확장 프로그램의 제어 수준입니다.

    • pixelSize

      숫자

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

반환 값

• Promise&lt;object&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  (details: object) => void

  • 세부정보

    객체

    • levelOfControl

      LevelOfControl

      설정에 대한 이 확장 프로그램의 제어 수준입니다.

    • pixelSize

      숫자

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

반환 값

• Promise&lt;object&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getFont()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • genericFamily

    GenericFamily

    글꼴을 검색해야 하는 일반 글꼴 모음입니다.

  • 스크립트

    ScriptCode 선택사항

    글꼴을 가져올 스크립트입니다. 생략된 경우, 전역 스크립트 (스크립트 코드 'Zyyy')의 글꼴 설정을 가져옵니다.

• 콜백

  함수 선택사항

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

  (details: object) => void

  • 세부정보

    객체

    • fontId

      문자열

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

    • levelOfControl

      LevelOfControl

      설정에 대한 이 확장 프로그램의 제어 수준입니다.

반환 값

• Promise&lt;object&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getFontList()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 콜백

  함수 선택사항

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

  (results: FontName[]) => void

  • 결과

    FontName[]

반환 값

• Promise&lt;FontName[]&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체(선택사항)

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

• 콜백

  함수 선택사항

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

  (details: object) => void

  • 세부정보

    객체

    • levelOfControl

      LevelOfControl

      설정에 대한 이 확장 프로그램의 제어 수준입니다.

    • pixelSize

      숫자

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

반환 값

• Promise&lt;object&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • pixelSize

    숫자

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • pixelSize

    숫자

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setFont()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • fontId

    문자열

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

  • genericFamily

    GenericFamily

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

  • 스크립트

    ScriptCode 선택사항

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

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

매개변수

• 세부정보

  객체

  • pixelSize

    숫자

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest 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

      숫자

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