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) }
| Comando | Descripció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) {
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)
) {
| Comando | Descripció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()
)
| Comando | Descripció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...") }
| Comando | Descripció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
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) {
conError = !correo.contains("@") || correo.length < 5
}
Column(
modifier = Modifier
.fillMaxSize()
.padding(24.dp)
) {
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()
)
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
Figura 2: Correo válido