Chrome で標準化された browser.* 名前空間がサポートされるようになりました（Chrome 148 以降で利用可能）。ドキュメントは順次更新されます。詳しくは、移行ガイドをご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

browser.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」）のフォントを選択し、キリル文字だけでなく、フォントがカバーするすべての文字（ラテン文字など）にこのフォントを使用します。

例

次のコードは、アラビア語の標準フォントを取得します。

browser.fontSettings.getFont(
  { genericFamily: 'standard', script: 'Arab' },
  function(details) { console.log(details.fontId); }
);

次のスニペットでは、日本語の Sans Serif フォントを設定しています。

browser.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」

「バリ」

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

「ハング」

"Hani"

「Hano」

「ハンス」

「Hant」

"Hebr"

「Hluw」

"Hmng"

「ハング」

「Inds」

"Ital"

"Java"

"Jpan"

「Jurc」

「Kali」

「Khar」

"Khmr"

「Khoj」

「Knda」

「Kpel」

「Kthi」

「ラナ」

「Laoo」

"Latf"

"Latg"

"Latn"

「Lepc」

「Limb」

「リナ」

「Linb」

「リス語」

「Loma」

「Lyci」

「Lydi」

「Mand」

「マニ」

「マヤ」

「Mend」

「Merc」

「Mero」

「Mlym」

「月」

「Mong」

「Mroo」

「Mtei」

「Mymr」

「Narb」

「Nbat」

「Nkgb」

「Nkoo」

「Nshu」

「オガム文字」

「Olck」

「Orkh」

「Orya」

「Osma」

「Palm」

「Perm」

「Phag」

"Phli"

「Phlp」

「Phlv」

「Phnx」

「Plrd」

「Prti」

「Rjng」

「Roro」

「Runr」

"Samr"

「サラ」

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

「タイ料理」

"Tibt"

「Tirh」

「Ugar」

「Vaii」

「Visp」

「ワラ」

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

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

説明

権限

コンセプトと使用方法

例

型

FontName

プロパティ

GenericFamily

列挙型

LevelOfControl

列挙型

ScriptCode

列挙型

メソッド

clearDefaultFixedFontSize()

パラメータ

戻り値

clearDefaultFontSize()

パラメータ

戻り値

clearFont()

パラメータ

戻り値

clearMinimumFontSize()

パラメータ

戻り値

getDefaultFixedFontSize()

パラメータ

戻り値

getDefaultFontSize()

パラメータ

戻り値

getFont()

パラメータ

戻り値

getFontList()

戻り値

getMinimumFontSize()

パラメータ

戻り値

setDefaultFixedFontSize()

パラメータ

戻り値

setDefaultFontSize()

パラメータ

戻り値

setFont()

パラメータ

戻り値

setMinimumFontSize()

パラメータ

戻り値

イベント

onDefaultFixedFontSizeChanged

パラメータ

onDefaultFontSizeChanged

パラメータ

onFontChanged

パラメータ

onMinimumFontSizeChanged

パラメータ

browser.fontSettings