このページは Cloud Translation API によって翻訳されました。

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 は「標準」汎用フォントファミリーの設定を使用します。

ウェブページで言語が指定されている場合、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"

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

「Bass」

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

「マニ」

「Maya」

「修復」

"Merc"

「メロ」

"Mlym"

「月」

「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」

「物語」

「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[]>

システム上のフォントのリストを取得します。

戻り値

Promise<FontName[]>

Chrome 96 以降

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
    
    数値
    
    フォントサイズ（ピクセル単位）。

chrome.fontSettings コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

説明

権限

コンセプトと使用方法

例

型

FontName

プロパティ

GenericFamily

列挙型

LevelOfControl

列挙型

ScriptCode

列挙型

メソッド

clearDefaultFixedFontSize()

パラメータ

戻り値

clearDefaultFontSize()

パラメータ

戻り値

clearFont()

パラメータ

戻り値

clearMinimumFontSize()

パラメータ

戻り値

getDefaultFixedFontSize()

パラメータ

戻り値

getDefaultFontSize()

パラメータ

戻り値

getFont()

パラメータ

戻り値

getFontList()

戻り値

getMinimumFontSize()

パラメータ

戻り値

setDefaultFixedFontSize()

パラメータ

戻り値

setDefaultFontSize()

パラメータ

戻り値

setFont()

パラメータ

戻り値

setMinimumFontSize()

パラメータ

戻り値

イベント

onDefaultFixedFontSizeChanged

パラメータ

onDefaultFontSizeChanged

パラメータ

onFontChanged

パラメータ

onMinimumFontSizeChanged

パラメータ

chrome.fontSettings