chrome.fontSettings

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.fontSettings لإدارة إعدادات الخط في 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، وهي مدرَجة في مرجع واجهة برمجة التطبيقات أدناه. عندما تحدّد صفحة ويب مجموعة خطوط عامة، يختار Chrome الخط استنادًا إلى الإعدادات المناسبة. في حال عدم تحديد مجموعة خطوط عامة، يستخدم Chrome إعدادات مجموعة الخطوط العامة "العادية".

عندما تحدد صفحة ويب لغة معيّنة، يختار Chrome الخط استنادًا إلى إعداد نص اللغة المعنيّة. في حال عدم تحديد أي لغة، يستخدم Chrome إعدادات النص التلقائي أو العام.

يتم تحديد نصوص اللغات المتوافقة من خلال رمز النص البرمجي ISO 15924 ويتم إدراجها في مرجع واجهة برمجة التطبيقات أدناه. من الناحية الفنية، لا تكون إعدادات Chrome خاصة بكل نص برمجي، بل تعتمد أيضًا على اللغة. على سبيل المثال، يختار Chrome الخط الخاص باللغة السيريلية (رمز النص البرمجي "Cyrl" وفقًا لمعيار ISO 15924) عندما تحدّد صفحة ويب اللغة الروسية، ويستخدم هذا الخط ليس فقط للنص السيريلي، بل لكل ما يغطيه الخط، مثل النص اللاتيني.

أمثلة

يحصل الرمز التالي على الخط العادي للغة العربية.

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

لتجربة واجهة برمجة التطبيقات هذه، ثبِّت مثال fontSettings API من مستودع chrome-extension-samples.

الأنواع

FontName

تمثّل هذه السمة اسم خط.

الخصائص

  • displayName

    سلسلة

    تمثّل هذه السمة الاسم المعروض للخط.

  • fontId

    سلسلة

    معرّف الخط

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

تعداد

"آفاق"

"العربية"

"Armi"

"Armn"

"Avst"

"بالي"

"Bamu"

"Bass"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"علب"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"مصر"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hang"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"كالي"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"طرف"

"لينا"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

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

"تانغ"

"Tavt"

"Telu"

‫"Teng"

"Tfng"

"Tglg"

"ثاء"

"Thai"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

الطُرق

clearDefaultFixedFontSize()

وعد 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<void>

تمحو هذه الطريقة حجم الخط الثابت التلقائي الذي تم ضبطه بواسطة هذا الامتداد، إن وُجد.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

clearDefaultFontSize()

وعد 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<void>

يزيل حجم الخط التلقائي الذي تم ضبطه بواسطة هذه الإضافة، إذا كان هناك أي حجم خط.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

clearFont()

وعد 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
): Promise<void>

يمحو الخط الذي تم ضبطه بواسطة هذه الإضافة، إن وُجد.

المعلمات

  • التفاصيل

    عنصر

    • genericFamily

      GenericFamily

      مجموعة الخطوط العامة التي يجب محو الخط منها

    • نص برمجي

      ScriptCode اختياري

      النص البرمجي الذي يجب محو الخط منه في حال حذفها، سيتم محو إعداد خط النص العالمي.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

clearMinimumFontSize()

وعد 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<void>

يزيل الحد الأدنى لحجم الخط الذي تم ضبطه بواسطة هذه الإضافة، إذا كان هناك حد أدنى.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getDefaultFixedFontSize()

وعد 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
): Promise<object>

تعرض هذه السمة الحجم التلقائي للخطوط ذات العرض الثابت.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

      • pixelSize

        الرقم

        حجم الخط بالبكسل

المرتجعات

  • Promise<object>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getDefaultFontSize()

وعد 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
): Promise<object>

تعرض هذه السمة حجم الخط التلقائي.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

      • pixelSize

        الرقم

        حجم الخط بالبكسل

المرتجعات

  • Promise<object>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getFont()

وعد 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
): Promise<object>

تعرض هذه السمة الخط لنص معيّن ومجموعة خطوط عامة.

المعلمات

  • التفاصيل

    عنصر

    • genericFamily

      GenericFamily

      مجموعة الخطوط العامة التي يجب استرداد الخط منها

    • نص برمجي

      ScriptCode اختياري

      تمثّل هذه السمة النص الذي يجب استرداد الخط منه. في حال حذفها، يتم استرداد إعداد الخط للنص البرمجي العام (رمز النص البرمجي "Zyyy").

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • fontId

        سلسلة

        معرّف الخط بدلاً من القيمة الحرفية للإعداد المفضّل لمعرّف الخط، قد يكون هذا هو معرّف الخط الذي يحلّ النظام قيمة الإعداد المفضّل إليه. لذا، يمكن أن يختلف fontId عن الخط الذي تم تمريره إلى setFont، إذا كان الخط غير متوفّر على النظام مثلاً. تشير السلسلة الفارغة إلى الرجوع إلى إعداد خط النص البرمجي العام.

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

المرتجعات

  • Promise<object>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getFontList()

وعد 
chrome.fontSettings.getFontList(
  callback?: function,
): Promise<FontName[]>

تعرض هذه السمة قائمة بالخطوط المتوفرة على النظام.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (results: FontName[]) => void

المرتجعات

  • Promise<FontName[]>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getMinimumFontSize()

وعد 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
): Promise<object>

تعرض هذه السمة الحد الأدنى لحجم الخط.

المعلمات

  • التفاصيل

    كائن اختياري

    هذه المَعلمة غير مستخدَمة حاليًا.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

      • pixelSize

        الرقم

        حجم الخط بالبكسل

المرتجعات

  • Promise<object>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setDefaultFixedFontSize()

وعد 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
): Promise<void>

تضبط هذه السمة الحجم التلقائي للخطوط ذات العرض الثابت.

المعلمات

  • التفاصيل

    عنصر

    • pixelSize

      الرقم

      حجم الخط بالبكسل

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setDefaultFontSize()

وعد 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
): Promise<void>

تضبط هذه السمة حجم الخط التلقائي.

المعلمات

  • التفاصيل

    عنصر

    • pixelSize

      الرقم

      حجم الخط بالبكسل

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setFont()

وعد 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
): Promise<void>

تضبط هذه السمة الخط لنص معيّن ومجموعة خطوط عامة.

المعلمات

  • التفاصيل

    عنصر

    • fontId

      سلسلة

      معرّف الخط تعني السلسلة الفارغة الرجوع إلى إعداد خط النص الشامل.

    • genericFamily

      GenericFamily

      مجموعة الخطوط العامة التي يجب ضبط الخط لها.

    • نص برمجي

      ScriptCode اختياري

      رمز البرنامج النصي الذي يجب ضبط الخط عليه. في حال حذفها، يتم ضبط إعدادات الخط للبرنامج النصي العام (رمز البرنامج النصي "Zyyy").

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setMinimumFontSize()

وعد 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
): Promise<void>

تضبط هذه السمة الحد الأدنى لحجم الخط.

المعلمات

  • التفاصيل

    عنصر

    • pixelSize

      الرقم

      حجم الخط بالبكسل

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

الفعاليات

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

        سلسلة

        معرّف الخط يمكنك الاطّلاع على الوصف في getFont.

      • genericFamily

        GenericFamily

        مجموعة الخطوط العامة التي تم تغيير إعدادات الخط فيها.

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

      • نص برمجي

        ScriptCode اختياري

        رمز البرنامج النصي الذي تم تغيير إعدادات الخط له

onMinimumFontSizeChanged

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

يتم تنشيط هذا الحدث عند تغيير إعداد الحد الأدنى لحجم الخط.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • levelOfControl

        LevelOfControl

        مستوى التحكّم الذي تملكه هذه الإضافة في الإعداد.

      • pixelSize

        الرقم

        حجم الخط بالبكسل