Validación de formularios

1. Declaración de la función

@Composable
fun emailTextField() {
    ...
    ...
}

¿Qué es @Composable?

  • Es una anotación que le dice a Jetpack Compose que esta función puede dibujar UI en la pantalla
  • Todas las funciones que crean interfaz visual deben tener esta anotación

¿Por qué se llama emailTextFiel?

  • Es el nombre que le dimos a nuestra función
  • Describe que vamos a crear un campo de texto para emails

2. Variables de estado

var email by rememberSaveable { mutableStateOf("") }
var conError by rememberSaveable { mutableStateOf(false) }
ComandoDescripción
email
  • Variable personalizada
  • Guarda el texto que el usuario escribe en el campo de email
  • Inicia como texto vacío ""
mutableStateOf
  • Crea una variable que puede cambiar de valor
  • Cuando cambia, la pantalla se redibuja automáticamente
rememberSaveable
  • Guarda el valor aunque rotemos el teléfono
  • Sin esto, si giras la pantalla pierdes lo que escribiste
by
  • Es “delegación de propiedad” en Kotlin
  • Nos permite escribir email = "nuevo" en lugar de email.value = "nuevo"
conError
  • Guara true si el email tiene errores o false si el email es válido
  • Inicia en false (sin error)

3. Función de validación

fun validar(correo: String) {
    //Expresiones regulares
    conError = !correo.contains("@") || correo.length < 5
}
  • Revisa el correo si es válido o no
  • Cambia el valor de conError según el resultado
  • Hay error si el correo no contiene “arroba” o tiene menos de 5 caracteres

4. Estructura del layout

Column(
    modifier = Modifier
        .fillMaxSize()
        .padding(24.dp)
) {
ComandoDescripción
Column
  • Un contenedor que apila elementos verticalmente (uno debajo del otro)
  • Como una columna de cajas
modifier
  • Nos permite modificar propiedades visuales del componente
.fillMaxSize()
  • Ocupa todo el tamaño disponible de la pantalla
.padding(24.dp)
  • Agrega un margen interno de 24dp (píxeles independientes de densidad)
  • Es como un “colchón” alrededor del contenido

5. El campo de texto: OutlinedTextField

OutlinedTextField(
    value = email,
    onValueChange = {
        email = it
        validar(it)
    },
    label = { Text("Email...") },
    isError = conError,
    singleLine = true,
    supportingText = {
        if (conError) {
            Text(
                text = "Correo inválido...",
                color = MaterialTheme.colorScheme.error
            )
        }
    },
    trailingIcon = {
        if (conError) {
            Icon(
                painter = painterResource(R.drawable.ic_error),
                contentDescription = "Error"
            )
        }
    },
    modifier = Modifier.fillMaxWidth()
)
ComandoDescripción
value = email
  • Muestra el contenido de la variable email
  • Es el texto que aparece en el campo
onValueChange
  • Se ejecuta cada vez que el usuario escribe algo
  • it representa el nuevo texto que escribió el usuario
label
  • Es el texto que aparece arriba del campo
  • Dice “Email…” para indicar qué debe escribir el usuario
isError
  • Si es true, el campo se pone rojo
  • Si es false, el campo se ve normal
singleLine
  • Solo permite una línea de texto
  • El usuario no puede hacer Enter para bajar la línea
  • Ideal para emails que siempre son una sola línea
supportingText
  • Muestra un texto de ayuda debajo del campo
  • Solo muestra el mensaje SI hay un error
trailingIcon
  • Es un ícono que aparece al final (derecha) del campo
  • Solo muestra el ícono SI hay error
fillMaxWidth
  • El campo ocupa todo el ancho disponible
  • Se estira horizontalmente

6. El botón

Button(
    onClick = { validar(email) },
    enabled = !conError,
    modifier = Modifier.fillMaxWidth()
) { Text("Enviar...") }
ComandoDescripción
onClick
  • Código que se ejecuta cuando presionas el botón
  • Llama a validar(email)
enabled
  • true -> el botón está activo (puedes presionarlo)
  • false -> el botón está desactivado (gris, no puedes presionarlo)
!conError
  • !conError = false -> botón desactivado
  • !conError = true -> botón activo

7. Código completo implementado

Formulario.kt

package com.example.clase05

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.unit.dp

@Composable
fun emailTextField() {
    var email by rememberSaveable { mutableStateOf("") }
    var conError by rememberSaveable { mutableStateOf(false) }

    fun validar(correo: String) {
        //Expresiones regulares
        conError = !correo.contains("@") || correo.length < 5
    }

    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(24.dp)
    ) {
        //region TextField
        OutlinedTextField(
            value = email,
            onValueChange = {
                val it = null
                email = it
                validar(it)
            },
            label = { Text("Email...") },
            isError = conError,
            singleLine = true,
            supportingText = {
                if (conError) {
                    Text(
                        text = "Correo inválido...",
                        color = MaterialTheme.colorScheme.error
                    )
                }
            },
            trailingIcon = {
                if (conError) {
                    Icon(
                        painter = painterResource(R.drawable.ic_error),
                        contentDescription = "Error"
                    )
                }
            },
            modifier = Modifier.fillMaxWidth()
        )
        //endregion

        Button(
            onClick = { validar(email) },
            enabled = !conError,
            modifier = Modifier.fillMaxWidth()
        ) {
            Text("Enviar...")
        }
    }
}

MainActivity.kt

package com.example.myapplication

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
import com.example.myapplication.ui.theme.MyApplicationTheme
import emailTextField

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MyApplicationTheme {
                emailTextField()  //
            }
        }
    }
}
Figura 1: Correo no válido
Correo no válido
Figura 2: Correo válido
Correo válido
BUSCARCtrl K