Adds structure to form creation and management on Android, supporting validation and error reporting. Enables defining custom validation functions and observing form fields for feedback and focus requests.
This simple library aims to add structure to the creation and management of forms on Android. From simple login forms to more complex forms that contain varying object types.
Add the dependency
dependencies {
// ...
implementation "com.nwagu.forms:forms:2.0.0-alpha09"
}
See sample activity for usage
Create your form fields and add them to an instance of Form.
val form = Form(viewModelScope)
val name = FormField<String>(required = true)
.apply {
addValidator { validateNotEmpty() }
addTo(form)
}
val gender = FormField<Gender>()
.apply {
addValidator { validateNonNullObject() }
addTo(form)
}
Update form
nameEdit.doOnTextChanged { text, start, count, after ->
name.value = text?.toString()
}
Set error reporting to begin on focus changed
nameEdit.setOnFocusChangeListener { v, hasFocus ->
if (!hasFocus)
name.errorReportingEnabled = true
}
Form fields expose observable feedback and error fields:
name.observe(
lifecycleScope,
onFeedback = {
// display helpful feedback
},
onError = {
nameEdit.error = it
},
onFocusRequest = {
// bring nameEdit to focus
}
)
focusRequest to bring the view to focus when the form field has an error.You can use this library now on Android or the JVM. I am currently trying it out on the other target platforms, especially iOS.
That's why it's still in alpha.
If you would like to use the older, stable, LiveData-based version of this library just for Android, please use version: 1.0.3.
Surfaced from shared tags and platforms — no rankings paid for.