ohos-validation-komensky

ohos-validation-komensky — это простая библиотека для проверки пользовательского ввода в формах с использованием аннотаций.

Возможности ohos-validation-komensky:

• проверка всех видов сразу и предоставление обратной связи пользователю. Одной строкой кода;
• проверка в реальном времени — проверка пользовательского ввода по мере перехода между видами с немедленной обратной связью;
• расширяемая библиотека — вы можете добавлять собственные проверки или адаптеры для пользовательских видов.

Инструкции по использованию

Доступен пример проекта, который содержит исполняемые примеры кода, демонстрирующие использование классов этого проекта, в папке sample/.

Как проверять

Сначала добавьте аннотации к вашим видам:

@NotEmpty(messageId = R.string.validation_name)
@MinLength(value = 3, messageId = R.string.validation_name_length, order = 2)
private EditText mNameEditText;

Теперь вы готовы выполнить следующее:

FormValidator.validate(this, new SimpleErrorPopupCallback(this, true, element));

Вы получите коллекцию всех неудачных проверок в обратном вызове и сможете представить их пользователю по своему усмотрению. Или просто используйте готовые обратные вызовы (например, SimpleErrorPopupCallback).

Проверка в реальном времени

Чтобы начать и остановить проверку в реальном времени, просто выполните следующие действия:

FormValidator.startLiveValidation(this, formContainer, new SimpleErrorPopupCallback(this, false, element));
FormValidator.stopLiveValidation();

Список всех поддерживаемых аннотаций для проверок

Проверки, поддерживаемые «из коробки»:

• NotEmpty:

@NotEmpty(messageId = R.string.validation_name, order = 1)
private EditText mNameEditText;

• MaxLength;
• MinLength:

@MinLength(value = 1, messageId = R.string.validation_participants, order = 2)
private EditText mNameEditText;

• MaxValue;
• MinValue:

@MinValue(value = 2L, messageId = R.string.validation_name_length)
private EditText mEditNumberOfParticipants;

• MaxNumberValue;
• MinNumberValue:

@MinNumberValue(value = "5.5", messageId = R.string.validation_name_length)
private EditText mEditPotentialOfHydrogen;

• RegExp:

@RegExp(value = EMAIL, messageId = R.string.validation_valid_email)
private EditText mEditEmail;
@RegExp(value = "^[0-9]+$", messageId = R.string.validation_valid_count)
private EditText mEditCount;

• DateInFuture:

@DateInFuture(messageId = R.string.validation_date)
private TextView mTxtDate;

• DateNoWeekend:

@DateNoWeekend(messageId = R.string.validation_date_weekend)
private TextView mTxtDate;

• Custom:

@Custom(value = MyVeryOwnValidator.class, messageId = R.string.validation_custom)
private EditText mNameEditText;

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

1. Чтобы использовать модуль ohos-validation-komensky в вашем примере приложения, добавьте следующие зависимости:

   dependencies {
       implementation project(':library')
       testImplementation 'junit:junit:4.13'
       ohosTestImplementation 'com.huawei.ohos.testkit:runner:1.0.0.100'
   }

2. Для использования... Оhos-validation-komensky в отдельном приложении добавьте указанные ниже зависимости и включите «library.har» в папку libs модуля entry:

   dependencies {
       implementation files('libs/library.har')
   }

Для использования ohos-validation-komensky из удалённого репозитория в отдельном приложении, добавьте указанные ниже зависимости в build.gradle модуля entry:

```
dependencies {
      implementation 'io.openharmony.tpc.thirdlib:ohos-validation-komensky:1.0.1'
}
```