cordova fonts

Кордова-Плагин-Фонты

Загрузить деятельность	Трэвис CI	Snyk

Плагин 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
• Amazon Fire OS (непроверенная / просто используя код Android)
• Firefox OS
• ios

Шрифты

Объект Fonts предоставляет способ перечислять список шрифтов, установленных на устройстве.

Методы

В настоящее время этот плагин предоставляет два метода, GetFontList и GetDefaultFont .

GetFontList

Параметры:

• SuccessCallback : обратный вызов, который возвращает список шрифтов как массив строковых значений.
• ErrorCallback: обратный вызов, который выполняется, если возникает ошибка при получении списка шрифтов на локальном устройстве.

Firefox OS причудливые

Firefox OS не предоставляет API для доступа к шрифтам на устройстве. Плагин шрифтов в настоящее время возвращает список, соответствующий файлу 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 не предоставляет API для доступа к шрифтам на устройстве. Плагин шрифтов в настоящее время возвращает жесткую строку для шрифта по умолчанию "Fira Sans Rigtion". См.

Пример

 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-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. Создайте и запустите приложение в эмуляторе или на устройстве.