cordova fonts

Cordova-plugin-fonts

ดาวน์โหลดกิจกรรม	Travis CI	สไนค์

ปลั๊กอิน Cordova ที่ระบุแบบอักษรที่ติดตั้งบนอุปกรณ์ท้องถิ่นและยังมีชื่อของแบบอักษรเริ่มต้น

ปลั๊กอินนี้กำหนดวัตถุ Fonts ทั่วโลกซึ่งให้การเข้าถึงแบบอักษรที่ติดตั้งบนอุปกรณ์ วัตถุ Fonts มีให้บริการจากวัตถุ navigator หลังจาก deviceready ไฟไหม้เหตุการณ์

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

การติดตั้ง

จากบรรทัดคำสั่ง:

 cordova plugin add cordova-plugin-fonts

config.xml สำหรับ build phonegap:

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

คำสั่งเหล่านี้จะติดตั้งปลั๊กอินจาก NPM คุณสามารถค้นหาปลั๊กอินนี้ได้ที่ NPM ได้ที่นี่หรือโดยการค้นหา ecosystem:cordova ในรีจิสทรี NPM เช่นนี้

แพลตฟอร์มที่รองรับ

• Android
• Amazon Fire OS (ยังไม่ได้ทดสอบ / ใช้รหัส Android)
• Firefox OS
• iOS

แบบอักษร

วัตถุ Fonts ให้วิธีการแจกแจงผ่านรายการแบบอักษรที่ติดตั้งบนอุปกรณ์

วิธีการ

ขณะนี้ปลั๊กอินนี้มีสองวิธีคือ GetFontList และ GetDefaultFont

getFontList

พารามิเตอร์:

• SuccessCallback : การโทรกลับที่ส่งคืนรายการฟอนต์เป็นอาร์เรย์ของค่าสตริง
• ErrorCallback: การโทรกลับที่เรียกใช้งานหากเกิดข้อผิดพลาดในขณะที่ดึงรายการตัวอักษรบนอุปกรณ์ท้องถิ่น

Firefox OS Quirks

Firefox OS ไม่ได้ให้ API เพื่อเข้าถึงแบบอักษรบนอุปกรณ์ ปลั๊กอินแบบอักษรในปัจจุบันส่งคืนรายการที่สอดคล้องกับไฟล์ Fonts.mk ที่พบในโครงการ Mozilla-B2G (https://github.com/mozilla-b2g/moztt/blob/master/fonts.mk)

ตัวอย่าง

 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 Quirks

Firefox OS ไม่ได้ให้ API เพื่อเข้าถึงแบบอักษรบนอุปกรณ์ ปลั๊กอินแบบอักษรในปัจจุบันจะส่งคืนสตริงที่ใช้รหัสฮาร์ดสำหรับฟอนต์เริ่มต้น "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?)");
}

การพัฒนาภายใน / การทดสอบหน่วย

(นี่เป็นเพียงสำหรับ devs ที่กำลังพัฒนา / ดีบักปลั๊กอินเอง)

ปลั๊กอิน Cordova-Fonts ใช้ Cordova-plugin-test-framework เพื่อเรียกใช้การทดสอบหน่วย กรอกข้อมูลต่อไปนี้เพื่อเรียกใช้ผ่านการทดสอบหน่วยปลั๊กอิน:

1. ใช้แอพ Cordova ที่มีอยู่ของคุณหรือสร้างแอพใหม่ นอกจากนี้คุณยังสามารถใช้โครงการทดสอบที่ได้รับการตั้งค่าไว้แล้วที่ https://github.com/eb1/test-fonts (เพียงแค่ใช้คำแนะนำที่แสดงอยู่ที่นั่นแทนโครงการด้านล่าง)

2. เพิ่มปลั๊กอิน Cordova-Fonts และปลั๊กอินทดสอบ / ทดสอบเฟรมเวิร์ก:

    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. เปลี่ยนหน้าเริ่มต้นใน config.xml ของแอป Cordova ด้วย <content src="cdvtests/index.html" /> หรือนำทางไปยัง cdvtests/index.html จากภายในแอปของคุณ

4. สร้างและเรียกใช้แอปพลิเคชันในตัวจำลองหรือบนอุปกรณ์