cordova fonts

Cordova-Plugin-FONTS

Aktivität herunterladen	Travis CI	Snyk

Ein Cordova -Plugin, das die auf dem lokalen Gerät installierten Schriftarten aufzählt und auch den Namen der Standardschrift für die Schriftart liefert.

Dieses Plugin definiert ein globales Fonts , das Zugriff auf die auf dem Gerät installierten Schriftarten ermöglicht. Das Fonts ist nach dem Brand des deviceready -Ereignisses im navigator -Objekt verfügbar.

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

Installation

Aus der Befehlszeile:

 cordova plugin add cordova-plugin-fonts

Config.xml für Telefonegap -Build:

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

Diese Befehle installieren das Plugin von NPM. Hier finden Sie dieses Plugin auf NPM oder durch die Suche nach ecosystem:cordova in der NPM -Registrierung wie dieser.

Unterstützte Plattformen

• Android
• Amazon Fire OS (ungetestet / nur mit Android -Code)
• Firefox OS
• iOS

Schriftarten

Das Fonts bietet eine Möglichkeit, die Liste der auf dem Gerät installierten Schriftarten aufzusetzen.

Methoden

Derzeit enthält dieses Plugin zwei Methoden, GetFontList und GetDefaultFont .

GetFontlist

Parameter:

• SuccessCallback : Rückruf, der die Liste der Schriftarten als Array von Stringwerten zurückgibt.
• Fehlercallback: Rückruf, der ausgeführt wird, wenn ein Fehler beim Abrufen der Liste der Schriftarten auf dem lokalen Gerät auftritt.

Firefox OS -Merkmale

Firefox OS stellt keine API zur Verfügung, um auf die Schriftarten auf dem Gerät zuzugreifen. Das Schriftstellungs-Plugin gibt derzeit eine Liste zurück, die der im Projekt von Mozilla-B2G gefundenen frisps.mk-Datei entspricht (https://github.com/mozilla-b2g/moztt/blob/master/fonts.mk), aber es handelt sich um eine hartgesetzte Liste und garantiert nicht, um auf einer bestimmten Version oder einer Distro-Distro-Distro-Distro-Distro-Distrikt von Firefox zu garantieren.

Beispiel

 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:

• SUCKTIONCALLBACK : Rückruf, der den Zeichenfolgennamen der Standardschrift auf dem Gerät zurückgibt.
• ERRORCALLBACK: Rückruf, der ausgeführt wird, wenn während des Anrufs ein Fehler auftritt.

Firefox OS -Merkmale

Firefox OS stellt keine API zur Verfügung, um auf die Schriftarten auf dem Gerät zuzugreifen. Das FONT-Plugin gibt derzeit eine hartcodierte Zeichenfolge für die Standardschrift "Fira Sans normal" zurück. Weitere Informationen finden Sie unter https://www.mozilla.org/en-us/styleguide/products/firefox-os/typeface/ für weitere Informationen.

Beispiel

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

Interne Entwicklung / Unit -Tests

(Dies gilt nur für Entwickler, die das Plugin selbst entwickeln / debuggen.)

Das Cordova-FONT-Plugin verwendet das Cordova-Plugin-Test-Framework, um Unit-Tests auszuführen. Führen Sie Folgendes ab, um die Plugin -Unit -Tests durchzuführen:

1. Verwenden Sie Ihre vorhandene Cordova -App oder erstellen Sie eine neue. Sie können auch das Testprojekt verwenden, das bereits unter https://github.com/eb1/test-fonts eingerichtet wurde (verwenden Sie einfach die dort aufgeführten Anweisungen anstelle der unten aufgeführten).

2. Fügen Sie das Plugin- und Test- / Test-Framework-Plugins von Cordova-FONT hinzu:

    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. Ändern Sie die Startseite in der Cordova -App config.xml mit <content src="cdvtests/index.html" /> oder navigieren Sie aus Ihrer App zu cdvtests/index.html .

4. Erstellen und führen Sie die Anwendung in einem Emulator oder auf dem Gerät aus.