cordova fonts

cordo-poigin-fonte

Télécharger l'activité	Travis CI	Snyk

Un plugin Cordova qui énumère les polices installées sur le périphérique local et fournit également le nom de la police par défaut.

Ce plugin définit un objet Global Fonts , qui donne accès aux polices installées sur l'appareil. L'objet Fonts est disponible à partir de l'objet navigator après les incendies de l'événement deviceready .

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

Installation

De la ligne de commande:

 cordova plugin add cordova-plugin-fonts

Config.xml pour la construction de téléphonie:

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

Ces commandes installeront le plugin à partir de NPM. Vous pouvez trouver ce plugin sur NPM ici, ou en recherchant ecosystem:cordova dans le registre NPM comme celui-ci.

Plates-formes prises en charge

• Androïde
• Amazon Fire OS (non testé / simplement en utilisant le code Android)
• Firefox OS
• ios

Polices

L'objet Fonts fournit un moyen d'énumérer la liste des polices installées sur l'appareil.

Méthodes

Actuellement, ce plugin fournit deux méthodes, GetFontlist et GetDefaultFont .

getFontlist

Paramètres:

• SuccessCallback : rappel qui renvoie la liste des polices comme un tableau de valeurs de chaîne.
• ErrorCallback: rappel qui s'exécute si une erreur se produit lors de la récupération de la liste des polices sur l'appareil local.

Firefox OS Quirks

Firefox OS ne fournit pas une API pour accéder aux polices sur l'appareil. Le plugin Fonts renvoie actuellement une liste correspondant au fichier fonts.mk trouvé dans le projet Mozilla-b2g (https://github.com/mozilla-b2g/moztt/blob/master/fonts.mk), mais il s'agit d'une liste dure-code et à ne pas être garanti d'être correct sur une version ou une distro particulière de Firefox Os.

Exemple

 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

Paramètres:

• SuccessCallback : rappel qui renvoie le nom de chaîne de la police par défaut sur l'appareil.
• errorCallback: rappel qui s'exécute si une erreur se produit pendant l'appel.

Firefox OS Quirks

Firefox OS ne fournit pas une API pour accéder aux polices sur l'appareil. Le plugin Fonts renvoie actuellement une chaîne codée dure pour la police par défaut "Fira Sans régulière". Voir https://www.mozilla.org/en-us/styleguide/products/firefox-os/typeface/ pour plus d'informations.

Exemple

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

Développement interne / test unitaire

(Ce n'est que pour les développeurs qui développent / déboguent le plugin lui-même)

Le plugin Cordova-Fontts utilise le Cordova-Plugin-Test-Framework pour exécuter des tests unitaires. Complétez ce qui suit pour exécuter les tests de l'unité du plugin:

1. Utilisez votre application Cordova existante ou créez-en une nouvelle. Vous pouvez également utiliser le projet de test qui a déjà été configuré pour cela sur https://github.com/eb1/test-fontts (utilisez simplement les instructions répertoriées là-bas au lieu de celles ci-dessous).

2. Ajouter le plugin Cordova-Fonts et les plugins Test / Test Framework:

    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. Modifiez la page Démarrer dans config.xml de votre application Cordova avec <content src="cdvtests/index.html" /> ou accédez à cdvtests/index.html à partir de votre application.

4. Créez et exécutez l'application dans un émulateur ou sur l'appareil.