Fundamentos de Flutter Widget
Widget es el bloque de construcción básico de la UI de Flutter.
En Flutter, todo es un Widget, desde texto simple hasta diseños de página complejos, todo está compuesto por Widgets.
¿Qué es un Widget?
Widget es una clase de Dart que describe la apariencia y el comportamiento de la UI. Cada aplicación Flutter es esencialmente una estructura de árbol compuesta por Widgets, llamada árbol de Widgets.
Ejemplo: el ejemplo de Widget más simple
// Define un Widget simple
class HelloWidget extends StatelessWidget {
const HelloWidget({super.key});
@override
Widget build(BuildContext context) {
// Devuelve un Widget Text, mostrando "Hello World"
return const Text('Hello World');
}
}
StatelessWidget - componente sin estado
StatelessWidget es un Widget inmutable; una vez creado, sus propiedades no se pueden cambiar. Es adecuado para escenarios que muestran contenido estático, como texto, imágenes, iconos, etc.
Estructura básica
Ejemplo: ejemplo de StatelessWidget
// Define un componente sin estado
class MyTextWidget extends StatelessWidget {
// Parámetros del constructor (propiedades inmutables)
final String text;
final Color textColor;
final double fontSize;
// Usa un constructor const
const MyTextWidget({
super.key,
required this.text,
this.textColor = Colors.black,
this.fontSize = 16.0,
});
@override
Widget build(BuildContext context) {
// El método build devuelve otro Widget
return Text(
text,
style: TextStyle(
color: textColor,
fontSize: fontSize,
),
);
}
}
// Ejemplo de uso
// MyTextWidget(text: 'Hello', textColor: Colors.red)
Casos de uso
- Exhibición de texto estático
- Visualización de imágenes
- Exhibición de iconos
- Diseños que no cambian con el tiempo
StatefulWidget - componente con estado
StatefulWidget es un Widget mutable que puede actualizar la UI a medida que cambian los datos internos. Es adecuado para escenarios que necesitan responder a la interacción del usuario o a cambios de datos.
Estructura básica
Ejemplo: ejemplo de StatefulWidget
// Define un componente con estado
class CounterWidget extends StatefulWidget {
const CounterWidget({super.key});
@override
State<CounterWidget> createState() => _CounterWidgetState();
}
// La clase State mantiene el estado mutable
class _CounterWidgetState extends State<CounterWidget> {
// Estado del contador
int _count = 0;
// Método para incrementar el contador
void _increment() {
// Llama a setState para notificar al framework que el estado ha cambiado
setState(() {
_count++;
});
}
@override
Widget build(BuildContext context) {
return Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
// Muestra el contador actual
Text(
'Contador: $_count',
style: const TextStyle(fontSize: 24),
),
const SizedBox(height: 16),
// Botón de incremento
ElevatedButton(
onPressed: _increment,
child: const Text('Incrementar'),
),
],
);
}
}
El método setState
En StatefulWidget, si el estado cambia, se debe llamar alsetStatemétodo para notificar a Flutter que reconstruya la UI.
Si se modifica el estado pero no se llama a setState, la UI no se actualizará. Esto se debe a que Flutter usa setState para determinar si es necesario reconstruir el Widget.
Casos de uso
- Datos dinámicos como contadores, cronómetros, etc.
- Entrada de formularios
- Agregar, eliminar y modificar elementos de la lista
- Respuesta a la interacción del usuario
El método build
Cada Widget debe implementar elbuildmétodo, que devuelve una parte del árbol de Widgets.
Reglas básicas
| Regla | Descripción |
|---|---|
| Valor de retorno | Debe devolver un Widget, no puede devolver null |
| Parámetros | Recibe el parámetro BuildContext, que indica la posición en el árbol de Widgets |
| Momento de llamada | En la construcción inicial, cuando el Widget padre se reconstruye, o cuando cambia el estado |
Ejemplo: ejemplo del método build
Widget build(BuildContext context) {
// BuildContext proporciona la capacidad de acceder al tema y otra información
// Por ejemplo, obtener el color del tema actual
final theme = Theme.of(context);
// Devuelve un Widget
return Container(
padding: const EdgeInsets.all(16.0),
decoration: BoxDecoration(
color: theme.colorScheme.primaryContainer,
borderRadius: BorderRadius.circular(8),
),
child: Text(
'Hello Flutter',
style: TextStyle(
color: theme.colorScheme.onPrimaryContainer,
fontSize: 20,
),
),
);
}
Widgets básicos comunes
Text - Mostrar texto
Ejemplo: Widget Text
const Text('Hello World')
// Texto con estilos
Text(
'Hello Flutter',
style: TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
color: Colors.blue,
),
)
// Texto con estilos opcionales
Text.rich(
TextSpan(
text: 'Hello ',
children: [
TextSpan(
text: 'Flutter',
style: TextStyle(fontWeight: FontWeight.bold),
),
],
),
)
Icon - Icono
Ejemplo: Widget Icon
const Icon(Icons.home) // Icono de inicio
const Icon(Icons.star, color: Colors.yellow) // Estrella con color
const Icon(Icons.settings, size: 48) // Icono de configuración de tamaño 48
Image - Imagen
Ejemplo: Widget Image
Image.network('https://example.com/image.png')
// Cargar imagen desde recursos locales
Image.asset('assets/images/logo.png')
// Cargar imagen desde un archivo
Image.file(File('path/to/image.png'))
// Imagen con parámetros
Image.network(
'https://example.com/image.png',
width: 200,
height: 200,
fit: BoxFit.cover,
)
Button - Botón
Ejemplo: Widget botón
TextButton(
onPressed: () { /* Manejar clic */ },
child: const Text('Botón de texto'),
)
// Botón flotante
FloatingActionButton(
onPressed: () { /* Manejar clic */ },
child: const Icon(Icons.add),
)
// ElevatedButton - botón con sombra
ElevatedButton(
onPressed: () { /* Manejar clic */ },
child: const Text('Enviar'),
)
// Botón con icono
ElevatedButton.icon(
onPressed: () { /* Manejar clic */ },
icon: const Icon(Icons.save),
label: const Text('Guardar'),
)
Composición de Widgets
La fortaleza de Flutter radica en que se pueden componer Widgets. Mediante la anidación, un Widget simple puede construir una UI compleja.
Ejemplo: Widget compuesto
const MyCard({super.key});
@override
Widget build(BuildContext context) {
return Card(
// Card es el componente de tarjeta de Material Design
elevation: 4, // Profundidad de la sombra
child: Padding(
padding: const EdgeInsets.all(16.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// Título
const Text(
'Título de la tarjeta',
style: TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
),
),
const SizedBox(height: 8),
// Texto de descripción
const Text(
'Este es el contenido descriptivo de la tarjeta, puede incluir varias líneas de texto.',
),
const SizedBox(height: 16),
// Fila de botones
Row(
mainAxisAlignment: MainAxisAlignment.end,
children: [
TextButton(
onPressed: () {},
child: const Text('Cancelar'),
),
const SizedBox(width: 8),
ElevatedButton(
onPressed: () {},
child: const Text('Confirmar'),
),
],
),
],
),
),
);
}
}