This library provides an easy-to-use and customizable solution for building forms in Android Jetpack Compose. It includes form fields such as text input, pickers, checkbox, and more, with built-in validators to ensure accurate user input. Data binding is also supported, making it easy to work with form data in your code.
The library uses reflection, to provide more flexibility in your form design. Whether you're building a complex registration form or a simple feedback form, this library has you covered.
To start using the library in your Android Compose project, follow these steps:
- Add the JitPack repository to your settings.gradle file
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
// ...
maven { url "https://jitpack.io" }
}
}
Note: In older Android projects, the repositories are defined in the root build.gradle file.
- Add the dependency in your build.gradle file.
implementation 'com.github.benjamin-luescher:compose-form:0.2.1'
In a first example we create a simple form with two text fields. The form will look like this:
- Create a your form class with your form field annotations (
@FormField
)
class MainForm(resourcesProvider: ResourcesProvider): Form() {
override fun self(): Form {
return this
}
@FormField
val name = FieldState(
state = mutableStateOf<String?>(null),
validators = mutableListOf(NotEmptyValidator())
)
@FormField
val lastName = FieldState(
state = mutableStateOf<String?>(null)
)
}
- Create a ViewModel for your form.
@HiltViewModel
class MainViewModel @Inject constructor(
resourcesProvider: ResourcesProvider
): ViewModel() {
var form = MainForm(resourcesProvider)
fun validate() {
form.validate(true)
Log.d("MainViewModel", "Validate (form is valid: ${form.isValid})")
}
}
- Add the fields in your composable UI.
Column {
TextField(
label = "Name",
form = viewModel.form,
fieldState = viewModel.form.name,
).Field()
TextField(
label = "Last Name",
form = viewModel.form,
fieldState = viewModel.form.lastName
).Field()
}
We now try to make a more complex form with different validators, date fields, password fields and searchable pickers. This is how the form will look like:
- Create a form class with form fields. Define form fields by the
@FormField
annotation.
// in this example we have a separate data class `Country` for a country picker.
data class Country(
val code: String,
val name: String
): PickerValue() {
override fun searchFilter(query: String): Boolean {
return this.name.startsWith(query)
}
}
class MainForm(resourcesProvider: ResourcesProvider): Form() {
override fun self(): Form {
return this
}
@FormField
val name = FieldState(
state = mutableStateOf<String?>(null),
validators = mutableListOf(
NotEmptyValidator(),
MinLengthValidator(
minLength = 3,
errorText = resourcesProvider.getString(R.string.error_min_length)
)
)
)
@FormField
val lastName = FieldState(
state = mutableStateOf<String?>(null)
)
@FormField
val password = FieldState(
state = mutableStateOf<String?>(null),
validators = mutableListOf(
NotEmptyValidator(),
MinLengthValidator(
minLength = 8,
errorText = resourcesProvider.getString(R.string.error_min_length)
)
)
)
@FormField
val passwordConfirm = FieldState(
state = mutableStateOf<String?>(null),
validators = mutableListOf(
IsEqualValidator({ password.state.value })
)
)
@FormField
val email = FieldState(
state = mutableStateOf<String?>(null),
validators = mutableListOf(
EmailValidator()
)
)
@FormField
val country = FieldState(
state = mutableStateOf<Country?>(null),
options = mutableListOf(
Country(code = "CH", name = "Switzerland"),
Country(code = "DE", name = "Germany"),
Country(code = "FR", name = "France"),
Country(code = "US", name = "United States"),
Country(code = "ES", name = "Spain"),
Country(code = "BR", name = "Brazil"),
Country(code = "CN", name = "China"),
),
optionItemFormatter = { "${it?.name}" },
validators = mutableListOf(
NotEmptyValidator()
)
)
@FormField
val startDate = FieldState(
state = mutableStateOf<Date?>(null),
validators = mutableListOf(
NotEmptyValidator()
)
)
@FormField
val endDate = FieldState(
state = mutableStateOf<Date?>(null),
validators = mutableListOf(
NotEmptyValidator(),
DateValidator(
minDateTime = {startDate.state.value?.time ?: 0},
errorText = resourcesProvider.getString(R.string.error_date_after_start_date)
)
)
)
@FormField
val agreeWithTerms = FieldState(
state = mutableStateOf<Boolean?>(null),
validators = mutableListOf(
IsEqualValidator({ true })
)
)
}
- Create a ViewModel for your form.
@HiltViewModel
class MainViewModel @Inject constructor(
resourcesProvider: ResourcesProvider
): ViewModel() {
var form = MainForm(resourcesProvider)
fun validate() {
form.validate(true)
Log.d("MainViewModel", "Validate (form is valid: ${form.isValid})")
}
}
- Add the fields in your composable UI.
Column {
TextField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Name",
form = viewModel.form,
fieldState = viewModel.form.name,
).Field()
TextField(
modifier = Modifier.padding(bottom = 8.dp),
label = "E-Mail",
form = viewModel.form,
fieldState = viewModel.form.email,
keyboardType = KeyboardType.Email
).Field()
PasswordField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Password",
form = viewModel.form,
fieldState = viewModel.form.password
).Field()
PasswordField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Password Confirm",
form = viewModel.form,
fieldState = viewModel.form.passwordConfirm
).Field()
TextField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Last Name",
form = viewModel.form,
fieldState = viewModel.form.lastName,
isEnabled = false,
).Field()
PickerField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Country",
form = viewModel.form,
fieldState = viewModel.form.country
).Field()
DateField(
modifier = Modifier.padding(bottom = 8.dp),
label = "Start Date",
form = viewModel.form,
fieldState = viewModel.form.startDate,
formatter = ::dateShort
).Field()
DateField(
modifier = Modifier.padding(bottom = 8.dp),
label = "End Date",
form = viewModel.form,
fieldState = viewModel.form.endDate,
formatter = ::dateLong
).Field()
CheckboxField(
modifier = Modifier.padding(bottom = 8.dp),
fieldState = viewModel.form.agreeWithTerms,
label = "I agree to Terms & Conditions",
form = viewModel.form
).Field()
}
- A variety of form fields to choose from, including text input, pickers, checkbox, and more
- Built-in validators to ensure accurate user input
- Data binding for easy management of form data in your code
This library is licensed under the MIT License.