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 の簡体字中国語に使用するフォントは、フォントと異なる場合があります。 使用します。

Chrome でサポートされている汎用フォント ファミリーは CSS 汎用フォント ファミリーに基づいており、 GenericReference に表示されます。ウェブページで汎用フォント ファミリーを指定している場合、 対応する設定に基づいてフォントが調整されます。汎用フォント ファミリーが指定されていない場合、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 汎用フォント ファミリーです。

列挙型

"standard"

"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」で表されます。

列挙型

「あああ」

"アラブ"

「Armi」

「武器」

"Avst"

"バリ"

"バム"

"低音"

"バット"

"ベン"

"ブリス"

"ボポ"

「ブラー」

"ブライ"

"ブギ"

"Buhd"

"Cakm"

"缶"

"Cari"

"Cham"

"Cher"

"Cirt"

「コプト」

「Cprt」

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

「エルバ」

"エティ"

"Geor"

"Geok"

「Glag」

"ゴス"

"グラン"

"グレック"

"Gujr"

"Guru"

「Hang」

"Hani"

"Hano"

"ハンズ"

「ハント」

"Hebr"

"Hluw"

"Hmng"

「ハング」

"Inds"

"イタリア"

"Java"

"Jpan"

「Jurc」

"カリ"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"あんな"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"リム"

"リナ"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

「マンド」

"マニ"

マヤ

修正

「メルク」

"Mero"

"Mlym"

"月"

"Mong"

"Mroo"

"Mtei"

"Mymr"

「ナーブ」

「Nbat」

"Nkgb"

「Nkoo」

「Nshu」

「オガム」

「オルク」

"Orkh"

"オリヤ"

"Osma"

"手のひら"

"パーマ"

"Phag"

"プリ"

「Phlp」

"Phlv"

"Phnx"

"Plrd"

「Prti」

"Rjng"

"Roro"

「Runr」

"サム"

"Sara"

"Sarb"

"Saur"

「Sgnw」

「Shaw」

「Shrd」

「シンド」

「シン」

「Sora」

「サンド」

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"テイル"

"Talu"

"Taml"

「タン」

"Tavt"

"Telu"

"テンポ"

「Tfng」

「Tglg」

「ター」

"タイ語"

"Tibt"

"Tirh"

"ウガー"

「Vaii」

"Visp"

「和ら」

"Wole"

"Xpeo"

「Xsux」

"Yiii"

"Zmth"

「Zsym」

「Zyyy」

メソッド

clearDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

この拡張機能で設定されているデフォルトの固定フォントサイズをクリアします（ある場合）。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

clearDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

この拡張機能で設定されているデフォルトのフォントサイズがあればクリアします。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

clearFont()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

この拡張機能で設定されているフォントを削除します（存在する場合）。

パラメータ

  • 詳細

    オブジェクト

    • genericFamily

      GenericFamily

      フォントを消去する汎用フォント ファミリー。

    • スクリプト

      ScriptCode （省略可）

      フォントをクリアするスクリプト。省略すると、グローバル スクリプト フォントの設定は消去されます。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

clearMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

この拡張機能で設定されている最小フォントサイズがあればクリアします。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

固定幅フォントのデフォルト サイズを取得します。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (details: object) => void

    • 詳細

      オブジェクト

      • levelOfControl

        LevelOfControl

        設定に対するこの拡張機能の制御レベル。

      • pixelSize

        数値

        フォントサイズ（ピクセル単位）。

戻り値

  • Promise&lt;object&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

デフォルトのフォントサイズを取得します。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (details: object) => void

    • 詳細

      オブジェクト

      • levelOfControl

        LevelOfControl

        設定に対するこの拡張機能の制御レベル。

      • pixelSize

        数値

        フォントサイズ（ピクセル単位）。

戻り値

  • Promise&lt;object&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getFont()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
)

指定されたスクリプトと汎用フォント ファミリーのフォントを取得します。

パラメータ

  • 詳細

    オブジェクト

    • genericFamily

      GenericFamily

      フォントを取得する必要がある汎用フォント ファミリー。

    • スクリプト

      ScriptCode （省略可）

      フォントを取得するスクリプト。省略した場合は、グローバル スクリプト（スクリプト コード「Zyyy」）のフォント設定が取得されます。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (details: object) => void

    • 詳細

      オブジェクト

      • fontId

        文字列

        フォント ID。リテラルのフォント ID 設定値ではなく、システムで設定値が解決されるフォントの ID である可能性があります。そのため、フォントがシステムで利用できない場合など、fontId は setFont に渡されたフォントとは異なることがあります。空の文字列は、スクリプト フォントのグローバル設定にフォールバックすることを示します。

      • levelOfControl

        LevelOfControl

        設定に対するこの拡張機能の制御レベル。

戻り値

  • Promise&lt;object&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getFontList()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.getFontList(
  callback?: function,
)

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

パラメータ

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (results: FontName[]) => void

戻り値

  • Promise&lt;FontName[]&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

最小フォントサイズを取得します。

パラメータ

  • 詳細

    オブジェクト（省略可）

    このパラメータは現在使用されていません。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (details: object) => void

    • 詳細

      オブジェクト

      • levelOfControl

        LevelOfControl

        設定に対するこの拡張機能の制御レベル。

      • pixelSize

        数値

        フォントサイズ（ピクセル単位）。

戻り値

  • Promise&lt;object&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

setDefaultFixedFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

固定幅フォントのデフォルト サイズを設定します。

パラメータ

  • 詳細

    オブジェクト

    • pixelSize

      数値

      フォントサイズ（ピクセル単位）。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

setDefaultFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

デフォルトのフォントサイズを設定します。

パラメータ

  • 詳細

    オブジェクト

    • pixelSize

      数値

      フォントサイズ（ピクセル単位）。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

setFont()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

指定したスクリプトと汎用フォント ファミリーのフォントを設定します。

パラメータ

  • 詳細

    オブジェクト

    • fontId

      文字列

      フォント ID。空の文字列は、スクリプト フォントのグローバル設定にフォールバックすることを意味します。

    • genericFamily

      GenericFamily

      フォントを設定する汎用フォント ファミリー。

    • スクリプト

      ScriptCode （省略可）

      フォントを設定するスクリプト コード。省略した場合は、グローバル スクリプト（スクリプト コード「Zyyy」）のフォント設定が設定されます。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

setMinimumFontSize()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

最小フォントサイズを設定します。

パラメータ

  • 詳細

    オブジェクト

    • pixelSize

      数値

      フォントサイズ（ピクセル単位）。

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    () => void

戻り値

  • 約束 <void>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

イベント

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

        数値

        フォントサイズ（ピクセル単位）。