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

import 'package:flutter/material.dart';

// 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

import 'package:flutter/material.dart';

// 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

import 'package:flutter/material.dart';

// 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

ReglaDescripción
Valor de retornoDebe devolver un Widget, no puede devolver null
ParámetrosRecibe el parámetro BuildContext, que indica la posición en el árbol de Widgets
Momento de llamadaEn la construcción inicial, cuando el Widget padre se reconstruye, o cuando cambia el estado

Ejemplo: ejemplo del método build

@override
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

// Texto básico
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

// Usa Material Icons
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

// Cargar imagen desde la red
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

// Botón de texto
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

class MyCard extends StatelessWidget {
  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'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}
Otras extensiones