cordova fonts

Cordova-plugin-font

Unduh aktivitas	Travis CI	Snyk

Plugin Cordova yang menyebutkan font yang diinstal pada perangkat lokal, dan juga memberikan nama font default.

Plugin ini mendefinisikan objek Fonts global, yang menyediakan akses ke font yang diinstal pada perangkat. Objek Fonts tersedia dari objek navigator setelah acara deviceready Fires.

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

Instalasi

Dari baris perintah:

 cordova plugin add cordova-plugin-fonts

Config.xml untuk phoneGap build:

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

Perintah ini akan menginstal plugin dari NPM. Anda dapat menemukan plugin ini di NPM di sini, atau dengan mencari ecosystem:cordova di registri NPM seperti ini.

Platform yang didukung

• Android
• Amazon Fire OS (belum teruji / hanya menggunakan kode Android)
• Firefox OS
• iOS

Font

Objek Fonts menyediakan cara untuk menyebutkan melalui daftar font yang diinstal pada perangkat.

Metode

Saat ini plugin ini menyediakan dua metode, GetFontList dan GetDefaultFont .

GetFontList

Parameter:

• SuccessCallback : Callback yang mengembalikan daftar font sebagai array nilai string.
• ErrorCallback: Callback yang mengeksekusi jika terjadi kesalahan saat mengambil daftar font pada perangkat lokal.

Firefox OS Quirks

Firefox OS tidak menyediakan API untuk mengakses font pada perangkat. Plugin Fonts saat ini mengembalikan daftar yang sesuai dengan file fonts.mk yang ditemukan dalam proyek MOZILLA-B2G (https://github.com/mozilla-b2g/moztt/blob/master/fonts.mk), tetapi ini adalah daftar kode yang keras dan tidak dijamin akan benar pada versi tertentu atau distro tertentu.

Contoh

 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

Parameter:

• SuccessCallback : Callback yang mengembalikan nama string font default pada perangkat.
• ErrorCallback: Callback yang mengeksekusi jika terjadi kesalahan selama panggilan.

Firefox OS Quirks

Firefox OS tidak menyediakan API untuk mengakses font pada perangkat. Plugin Fonts saat ini mengembalikan string kode keras untuk font default "Fira Sans Reguler". Lihat https://www.mozilla.org/en-us/styleguide/products/firefox-os/typeface/ untuk informasi lebih lanjut.

Contoh

 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?)");
}

Pengembangan Internal / Pengujian Unit

(Ini hanya untuk devs yang sedang mengembangkan / men -debug plugin itu sendiri)

Plugin Cordova-Fonts menggunakan cordova-plugin-test-framework untuk menjalankan tes unit. Lengkapi yang berikut untuk dijalankan melalui Tes Unit Plugin:

1. Gunakan aplikasi Cordova yang ada, atau buat yang baru. Anda juga dapat menggunakan proyek uji yang telah diatur untuk ini di https://github.com/eb1/test-fonts (cukup gunakan instruksi yang tercantum di sana alih-alih yang di bawah).

2. Tambahkan plugin Cordova-Fonts dan Plugin Kerangka Tes / Tes:

    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. Ubah halaman Mulai di config.xml aplikasi Cordova Anda dengan <content src="cdvtests/index.html" /> atau navigasikan ke cdvtests/index.html dari dalam aplikasi Anda.

4. Bangun dan jalankan aplikasi dalam emulator atau di perangkat.