chrome.fontSettings

الوصف

استخدِم واجهة برمجة التطبيقات 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 الصينية المبسطة عن الخط يُستخدم باللغة اليابانية بذنابة.

تستند مجموعات الخطوط العامة التي يتيحها Chrome إلى مجموعات الخطوط العامة في CSS وهي في مرجع واجهة برمجة التطبيقات أدناه. عندما تحدد صفحة ويب مجموعة خطوط عامة، يحدد Chrome الخط بناءً على الإعداد المقابل. وإذا لم يتم تحديد مجموعة خطوط عامة، فسيستخدم Chrome إعداد "القياسي" مجموعة الخطوط العامة.

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

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

أمثلة

تحصل الكود التالي على الخط القياسي للعربية.

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 من chrome-extension-samples. المستودع.

الأنواع

FontName

يمثل اسم خط.

أماكن إقامة

  • displayName

    سلسلة

    الاسم المعروض للخط.

  • fontId

    سلسلة

    رقم تعريف الخط.

GenericFamily

مجموعة خطوط عامة في CSS.

Enum

"عادي"

"sansserif"

"serif"

"تم الإصلاح"

"تدوين"

"خيال"

"math"

LevelOfControl

أحد not\_controllable: لا يمكن التحكّم فيه من خلال أي إضافة controlled\_by\_other\_extensions: تتحكّم فيها إضافات ذات أولوية أعلى controllable\_by\_this\_extension: يمكن التحكّم فيها من خلال هذه الإضافة controlled\_by\_this\_extension: تتحكّم فيها هذه الإضافة

Enum

"not_controllable"

"controlled_by_other_extensions"
.

"controllable_by_this_extension"

"controlled_by_this_extension"
.

ScriptCode

رمز نص برمجي ISO 15924 يتم تمثيل النص البرمجي الافتراضي أو العمومي بكود البرنامج النصي "Zyyy".

Enum

"Afak"

"العربية"

"الجيش"

"أرغن"

"Avst"

"بالي"

"بامو"

"اصطلاح"

"دفعة"

"بنغ"

"Blis"

"بوبو"

"براه"

"براي"

"بوجي"

"بوهاد"

"Cakm"

"العلب"

"كاري"

"تشام"

"شير"

"دائرة"

"القبطية"

"Cprt"

"سيرل"

"Cyrs"

"ديفا"

"Dsrt"

"مزدوج"

مصر

"مصر"

"مصر"

"إلبا"

"Ethi"

"Geor"

"Geok"

"جلّاج"

"القوطية"

"غران"

"الغريك"

"غوجر"

"الخبير"

"تعليق"

"هاني"

"هانو"

"هان"

"هان"

"الخبَر"

"هدوء"

"همنج"

"تعليق"

"الإنفاقات"

"إيطالي"

"Java"

"اليابان"

"جورك"

"كالي"

"خار"

"خمر"

"الخوج"

"الكندا"

"Kpel"

"الكثي"

"Lana"

"لاو"

"لاتف"

"خط الطول"

"خط الطول"

"Lepc"

"طرف"

"لينا"

"Linb"

"Lisu"

"Loma"

"Lyci"

"ليدي"

"رجل"

"ماني"

"مايا"

"الإصلاح"

"Merc"

"Mero"

"Mlym"

"القمر"

"مونغ"

"Mroo"

"Mtei"

"Mymr"

"مطعم"

النبت

"Nkgb"

"Nkoo"

"نشو"

"أوغام"

"أولك"

"أورخ"

"الأوريا"

"Osma"

"نعال"

"بيرم"

"باج"

"فلي"

"Phlp"

"فلف"

"Phnx"

"Plrd"

"برتي"

"Rjng"

"رورو"

"Runr"

"سمر"

"سارة"

"صرف"

"صور"

"Sgnw"

"شو"

"Shrd"

"سند"

"السينه"

"سورا"

"الأحد"

"Sylo"

"سيرك"

"Syre"

"سيرج"

"سيرن"

"الإشارة"

تكر

"تالي"

"تالو"

"التاملية"

"تانغ"

"Tavt"

"تيلو"

"تنغ"

Tfng

"Tglg"

"تا"

"التايلاندية"

"التيب"

"طر"

"أوغار"

"فاي"

"Visp"

"Wara"

"صوف"

"Xpeo"

"Xsux"

"يي"

"Zmth"

"Zsym"

"Zyyy"

الطُرق

clearDefaultFixedFontSize()

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

يؤدي هذا الإجراء إلى محو حجم الخط الثابت التلقائي الذي تضبطه هذه الإضافة، إن توفّر.

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

clearDefaultFontSize()

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

يؤدي هذا الإجراء إلى محو حجم الخط التلقائي الذي تضبطه هذه الإضافة، في حال توفّره.

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

clearFont()

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

يؤدي هذا الإجراء إلى محو الخط الذي تحدّده هذه الإضافة، في حال توفّره.

المعلمات

  • التفاصيل

    كائن

    • genericFamily

      GenericFamily

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

    • نص برمجي

      ScriptCode اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

clearMinimumFontSize()

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

يؤدي هذا الإجراء إلى محو الحد الأدنى لحجم الخط الذي تحدّده هذه الإضافة، إن وجد.

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

getDefaultFixedFontSize()

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

الحصول على الحجم التلقائي للخطوط ذات العرض الثابت.

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    (details: object) => void

    • التفاصيل

      كائن

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        الرقم

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

المرتجعات

  • Promise&lt;object&gt;

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

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

getDefaultFontSize()

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

الحصول على حجم الخط التلقائي

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    (details: object) => void

    • التفاصيل

      كائن

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        الرقم

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

المرتجعات

  • Promise&lt;object&gt;

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

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

getFont()

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

يحصل على الخط لنص برمجي معيّن وعائلة خطوط عامة.

المعلمات

  • التفاصيل

    كائن

    • genericFamily

      GenericFamily

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

    • نص برمجي

      ScriptCode اختياري

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

  • رد الاتصال

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

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

    (details: object) => void

    • التفاصيل

      كائن

      • fontId

        سلسلة

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

      • levelOfControl

        LevelOfControl

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

المرتجعات

  • Promise&lt;object&gt;

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

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

getFontList()

وعود 
chrome.fontSettings.getFontList(
  callback?: function,
)

الحصول على قائمة بالخطوط على النظام

المعلمات

  • رد الاتصال

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

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

    (results: FontName[]) => void

المرتجعات

  • Promise&lt;FontName[]&gt;

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

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

getMinimumFontSize()

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

الحصول على الحد الأدنى لحجم الخط

المعلمات

  • التفاصيل

    الكائن اختياري

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

  • رد الاتصال

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

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

    (details: object) => void

    • التفاصيل

      كائن

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        الرقم

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

المرتجعات

  • Promise&lt;object&gt;

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

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

setDefaultFixedFontSize()

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

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

المعلمات

  • التفاصيل

    كائن

    • pixelSize

      الرقم

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

setDefaultFontSize()

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

لضبط حجم الخط التلقائي.

المعلمات

  • التفاصيل

    كائن

    • pixelSize

      الرقم

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

setFont()

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

لضبط الخط لنص برمجي معيّن ومجموعة خطوط عامة معيّنة.

المعلمات

  • التفاصيل

    كائن

    • fontId

      سلسلة

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

    • genericFamily

      GenericFamily

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

    • نص برمجي

      ScriptCode اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

setMinimumFontSize()

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

لضبط الحدّ الأدنى لحجم الخط.

المعلمات

  • التفاصيل

    كائن

    • pixelSize

      الرقم

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

    لا تتوفّر الوعود إلا مع إصدار 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

        سلسلة

        رقم تعريف الخط. يمكنك الاطّلاع على الوصف باللغة getFont.

      • genericFamily

        GenericFamily

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

      • levelOfControl

        LevelOfControl

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

      • نص برمجي

        ScriptCode اختياري

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

onMinimumFontSizeChanged

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

يتم الإطلاق عند تغيير إعداد الحدّ الأدنى لحجم الخط.

المعلمات

  • رد الاتصال

    دالة

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

    (details: object) => void

    • التفاصيل

      كائن

      • levelOfControl

        LevelOfControl

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

      • pixelSize

        الرقم

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