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 ببعض إعدادات الخطوط بالاعتماد على مجموعات خطوط عامة وبعض النصوص البرمجية اللغوية. على سبيل المثال، قد يختلف الخط المستخدَم في اللغة الصينية المبسّطة بدون ذنابة عن الخط المستخدَم في اللغة serif اليابانية.

تستند مجموعات الخطوط العامة التي يتيحها 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); }
);

يحدد المقتطف التالي خط sans-serif باللغة اليابانية.

chrome.fontSettings.setFont(
  { genericFamily: 'sansserif', script: 'Jpan', fontId: 'MS PGothic' }
);

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

الأنواع

FontName

تمثل اسم خط.

أماكن إقامة

• displayName

  سلسلة

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

• fontId

  سلسلة

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

GenericFamily

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

التعداد

"sansserif"

"serif"

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"

"Avst"

"Batk"

"Blis"

"Brah"

"Buhd"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Egyh"

"Ethi"

"Geor"

"Geok"

"Glag"

"Hano"

"Hluw"

"Java"

"Jurc"

"Khmr"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Latf"

"Latg"

"Latn"

"Lepc"

"Loma"

"Lyci"

"Lydi"

"Merc"

"Mero"

"Mlym"

"Mroo"

"Mymr"

"Narb"

"Nkgb"

"Nkoo"

"Nshu"

"Perm"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Samr"

"Sgnw"

"Sylo"

"Syrc"

"Syre"

"Syrn"

"Tagb"

"Takr"

"Taml"

"Tavt"

"Telu"

"Tfng"

"Tglg"

"Tibt"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Zmth"

"Zsym"

"Zyyy"

الطُرق

clearDefaultFixedFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

clearDefaultFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

clearFont()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • genericFamily

    GenericFamily

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

  • نص برمجي

    ScriptCode اختيارية

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

clearMinimumFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

getDefaultFixedFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (details: object)=>void

  • التفاصيل

    كائن

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      الرقم

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

المرتجعات

• Promise<object>

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

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

getDefaultFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (details: object)=>void

  • التفاصيل

    كائن

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      الرقم

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

المرتجعات

• Promise<object>

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

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

getFont()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • genericFamily

    GenericFamily

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

  • نص برمجي

    ScriptCode اختيارية

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (details: object)=>void

  • التفاصيل

    كائن

    • fontId

      سلسلة

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

    • levelOfControl

      LevelOfControl

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

المرتجعات

• Promise<object>

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

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

getFontList()

وعد

chrome.fontSettings.getFontList(
  callback?: function,
)

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (results: FontName[])=>void

  • النتائج

    FontName[]

المرتجعات

• Promise<FontName[]>

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

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

getMinimumFontSize()

وعد

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

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

المَعلمات

• التفاصيل

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (details: object)=>void

  • التفاصيل

    كائن

    • levelOfControl

      LevelOfControl

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

    • pixelSize

      الرقم

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

المرتجعات

• Promise<object>

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

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

setDefaultFixedFontSize()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • pixelSize

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setDefaultFontSize()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • pixelSize

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setFont()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • fontId

    سلسلة

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

  • genericFamily

    GenericFamily

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

  • نص برمجي

    ScriptCode اختيارية

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setMinimumFontSize()

وعد

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

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

المَعلمات

• التفاصيل

  كائن

  • pixelSize

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

      الرقم

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