Проект edittext-mask

Введение в проект

• Название проекта: edittext-mask.
• Серия: openharmony, адаптация сторонних компонентов.
• Функция: поддержка маскирования (скрытие) содержимого для пользовательского компонента поля ввода.
• Состояние переноса проекта: основная функция реализована на 80%.
• Отличия при вызове: не реализованы некоторые свойства, такие как установка курсора и изменение цвета определённого фрагмента текста.
• Версия разработки: sdk6, DevEco Studio2.2 Beta1.
• Базовая версия: Release 1.0.5.

Демонстрация эффекта

Инструкция по установке

1. В файле build.gradle в корневом каталоге проекта добавьте:

allprojects {
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/releases/'
    }
}
}

2. В файл build.gradle модуля entry добавьте:

dependencies {
    implementation 'com.gitee.chinasoft_ohos:MaskedEditText:1.0.2'
}

После этого проект можно запустить под sdk6 и DevEco Studio2.2 Beta1. Если запуск не удался, удалите файлы .gradle, .idea, build, gradle и build.gradle и создайте новый проект, скопировав соответствующие файлы из нового проекта в корневой каталог.

Использование

Добавьте строку implementation 'com.gitee.chinasoft_ohos:MaskedEditText:0.0.1-SNAPSHOT' в свой файл entry build.gradle или загрузите проект и используйте его как библиотеку. В корне каталога макета добавьте строку кода xmlns:app="http://schemas.huawei.com/res/ohos/". После этого вы можете использовать атрибут app:.

<br.com.sapereaude.maskedEditText.MaskedEditText ohos:id="@+id/masked" ohos:layout_width="match_parent" ohos:layout_height="40vp" ohos:text_input_type="pattern_number" app:allowed_chars="1234567890" app:mask="+7(###)###-##-##" app:hint="1234567890" app:keep_hint="true" />

Здесь mask — это маска ввода, которую вы хотите использовать, а # — редактируемое место (будет заменено пробелом на экране). Вы можете выбрать символы для отображения (если вы не хотите использовать #):

<br.com.sapereaude.maskedEditText.MaskedEditText ohos:layout_width="match_parent" ohos:layout_height="40vp" app:mask="ccc.ccc.ccc-cc" app:char_representation="c" />

Также вы можете изменить маску и отображаемые символы программно:

MaskedEditText editText = (MaskedEditText) findViewById(R.id.my_edit_text) // Установка символа представления на '$' editText.setCharRepresentation('$'); // Регистрация символа представления Log.i("Representation character", editText.getCharRepresentation()); // Установка маски editText.setMask("##/##/####"); // Регистрация маски Log.i("Mask", editText.getMask());

Чтобы включить действия мягкой клавиатуры (действия IME), используйте:

<br.com.sapereaude.maskedEditText.MaskedEditText ... app:enable_ime_action="true" ... /> или установите значение true программно:

MaskedEditText editText = (MaskedEditText) findViewById(ResourceTable.Id_masked) editText.setImeActionEnabled(true);

Тестирование

• CodeCheck: тестирование кода без исключений.
• CloudTest: тестирование кода без исключений.
• Вирусная безопасность: проверка пройдена.
• Демоверсия текущей версии: основные функции соответствуют исходному компоненту.

Версии

• 1.0.2