cordova fonts

Cordova-Plugin-Fonts

تنزيل النشاط	ترافيس سي	سنيك

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

يحدد هذا البرنامج المساعد كائن Fonts العالمية ، والذي يوفر الوصول إلى الخطوط المثبتة على الجهاز. كائن Fonts متاح من كائن navigator بعد حرائق الحدث deviceready .

 document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.Fonts);
}

تثبيت

من سطر الأوامر:

 cordova plugin add cordova-plugin-fonts

config.xml لبناء phonegap:

 <gap:plugin name="cordova-plugin-fonts" source="npm" />

سوف هذه الأوامر تثبيت البرنامج المساعد من NPM. يمكنك العثور على هذا البرنامج المساعد على NPM هنا ، أو عن طريق البحث عن ecosystem:cordova في سجل NPM مثل هذا.

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

• Android
• OS Amazon Fire OS (لم يتم اختباره / فقط باستخدام رمز Android)
• OS Firefox
• iOS

الخطوط

يوفر كائن Fonts وسيلة للتعداد من خلال قائمة الخطوط المثبتة على الجهاز.

طُرق

يوفر هذا البرنامج المساعد حاليًا طريقتين ، GetFontList و GetDefaultFont .

getFontlist

حدود:

• SuccessCallback : رد الاتصال الذي يرجع قائمة الخطوط كمجموعة من قيم السلسلة.
• ErrorCallback: رد الاتصال الذي ينفذ في حالة حدوث خطأ أثناء استرداد قائمة الخطوط على الجهاز المحلي.

Firefox OS المراوغات

لا يوفر Firefox OS واجهة برمجة تطبيقات للوصول إلى الخطوط على الجهاز. يقوم المكون الإضافي Fonts حاليًا بإرجاع قائمة تتوافق مع ملف Fonts.mk الموجود في مشروع Mozilla-b2g (https://github.com/mozilla-b2g/moztt/blob/master/fonts.mk) ، لكنها قائمة مرموسة ولا تضمن أن تكون صحيحة في أي نسخة أو توزيعات من Firefox Os.

مثال

 if (navigator.Fonts) {
    console.log("Fonts object in navigator");
    navigator.Fonts.getFontList(
        function (fontList) {
            if (fontlist) {
                for (var i = 0; i < fontlist.length; i++) {
                    console.log("Font: " + fontlist[i]);
                }
            }
        },
        function (error) {
            console.log("FontList error: " + error);
        }
    );
} else {
    console.log("Plugin error: Fonts plugin not found (is it installed?)");
}

getDefaultFont

حدود:

• SuccessCallback : رد الاتصال الذي يرجع اسم سلسلة الخط الافتراضي على الجهاز.
• ErrorCallback: رد الاتصال الذي ينفذ في حالة حدوث خطأ أثناء المكالمة.

Firefox OS المراوغات

لا يوفر Firefox OS واجهة برمجة تطبيقات للوصول إلى الخطوط على الجهاز. يقوم المكون الإضافي Fonts حاليًا بإرجاع سلسلة مشفرة للخطية للخط الافتراضي "Fira Sans العادي". انظر https://www.mozilla.org/en-us/styleguide/products/firefox-os/typeface/ لمزيد من المعلومات.

مثال

 if (navigator.Fonts) {
    console.log("Fonts object in navigator");
    navigator.Fonts.getDefaultFont(
        function (defaultFont) {
            if (defaultFont) {
                console.log("Default Font: " + defaultFont);
            }
        },
        function (error) {
            console.log("DefaultFont error: " + error);
        }
    );
} else {
    console.log("Plugin error: Fonts plugin not found (is it installed?)");
}

التطوير الداخلي / اختبار الوحدة

(هذا فقط للداخل الذين يقومون بتطوير / تصحيح المكون الإضافي نفسه)

يستخدم المكون الإضافي Cordova-Fonts سيارة Cordova-Plugin-Test-Framework لتشغيل اختبارات الوحدة. أكمل ما يلي للتشغيل من خلال اختبارات وحدة البرنامج المساعد:

1. استخدم تطبيق Cordova الحالي ، أو إنشاء تطبيق جديد. يمكنك أيضًا استخدام مشروع الاختبار الذي تم إعداده بالفعل لهذا على https://github.com/eb1/test-fonts (فقط استخدم الإرشادات المدرجة هناك بدلاً من الإرشادات أدناه).

2. أضف المكون الإضافي للإضافات والاختبار / الاختبار الإضافي: أضف مكونات الإضافات الإضافية:

    cordova plugin add https://github.com/adapt-it/cordova-fonts.git
    cordova plugin add https://github.com/adapt-it/cordova-fonts.git#:/tests
    cordova plugin add https://github.com/apache/cordova-plugin-test-framework.git
   

3. قم بتغيير صفحة START في CORDOVA App الخاص بك config.xml مع <content src="cdvtests/index.html" /> أو انتقل إلى cdvtests/index.html من داخل التطبيق الخاص بك.

4. بناء وتشغيل التطبيق في محاكي أو على الجهاز.