الوصف
استخدِم واجهة برمجة التطبيقات 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
مجموعة الخطوط العامة التي يجب محو الخط لها.
-
نص برمجي
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
مستوى تحكُّم هذه الإضافة في الإعداد.
-
pixelSize
الرقم
حجم الخط بالبكسل
-
-
المرتجعات
-
Promise<object>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
getDefaultFontSize()
chrome.fontSettings.getDefaultFontSize(
details?: object,
callback?: function,
)
الحصول على حجم الخط التلقائي.
المَعلمات
-
التفاصيل
الكائن اختياري
هذه المَعلمة غير مستخدَمة حاليًا.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
levelOfControl
مستوى تحكُّم هذه الإضافة في الإعداد.
-
pixelSize
الرقم
حجم الخط بالبكسل
-
-
المرتجعات
-
Promise<object>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
getFont()
chrome.fontSettings.getFont(
details: object,
callback?: function,
)
الحصول على الخط لنص برمجي معيّن ومجموعة خطوط عامة.
المَعلمات
-
التفاصيل
كائن
-
genericFamily
مجموعة الخطوط العامة التي يجب استرداد الخط لها.
-
نص برمجي
ScriptCode اختيارية
النص البرمجي الذي يجب استرداد الخط له. في حال حذفها، يتم استرداد إعداد الخط للنص البرمجي العام (رمز النص البرمجي "Zyyy").
-
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
fontId
سلسلة
تمثّل هذه السمة معرّف الخط. وبدلاً من القيمة الحرفية لتفضيل معرّف الخط، قد يكون هذا هو معرّف الخط الذي يحل النظام قيمة التفضيل إليه. ولذلك، يمكن أن يختلف
fontId
عن الخط الذي تم تمريره إلىsetFont
، إذا لم يكن الخط مثلاً متاحًا في النظام مثلاً. تشير السلسلة الفارغة إلى الرجوع إلى إعداد خط النص البرمجي العام. -
levelOfControl
مستوى تحكُّم هذه الإضافة في الإعداد.
-
-
المرتجعات
-
Promise<object>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
getFontList()
chrome.fontSettings.getFontList(
callback?: function,
)
الحصول على قائمة بالخطوط على النظام
المَعلمات
المرتجعات
-
Promise<FontName[]>
Chrome 96 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
getMinimumFontSize()
chrome.fontSettings.getMinimumFontSize(
details?: object,
callback?: function,
)
الحصول على الحد الأدنى لحجم الخط
المَعلمات
-
التفاصيل
الكائن اختياري
هذه المَعلمة غير مستخدَمة حاليًا.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
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
مجموعة الخطوط العامة التي يجب تعيين الخط لها.
-
نص برمجي
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
مستوى تحكُّم هذه الإضافة في الإعداد.
-
pixelSize
الرقم
حجم الخط بالبكسل
-
-
onDefaultFontSizeChanged
chrome.fontSettings.onDefaultFontSizeChanged.addListener(
callback: function,
)
يتم تنشيطها عند تغيير إعدادات حجم الخط التلقائي.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
levelOfControl
مستوى تحكُّم هذه الإضافة في الإعداد.
-
pixelSize
الرقم
حجم الخط بالبكسل
-
-
onFontChanged
chrome.fontSettings.onFontChanged.addListener(
callback: function,
)
يتم تنشيطها عند تغيير أحد إعدادات الخط.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
fontId
سلسلة
تمثّل هذه السمة معرّف الخط. اطّلِع على الوصف باللغة
getFont
. -
genericFamily
مجموعة الخطوط العامة التي تم تغيير إعداد الخط لها.
-
levelOfControl
مستوى تحكُّم هذه الإضافة في الإعداد.
-
نص برمجي
ScriptCode اختيارية
رمز النص البرمجي الذي تم تغيير إعداد الخط له.
-
-
onMinimumFontSizeChanged
chrome.fontSettings.onMinimumFontSizeChanged.addListener(
callback: function,
)
يتم تنشيطها عند تغيير إعدادات الحد الأدنى لحجم الخط.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(details: object) => void
-
التفاصيل
كائن
-
levelOfControl
مستوى تحكُّم هذه الإضافة في الإعداد.
-
pixelSize
الرقم
حجم الخط بالبكسل
-
-