Tkinter LabelFrame: Una guía práctica y amigable

1 ¿Qué es un LabelFrame?

LabelFrame es un widget contenedor en Tkinter que dibuja un borde y un título alrededor de un grupo de controles relacionados. Es la forma estándar de organizar secciones; piénsalo como una tarjeta etiquetada que recopila configuraciones relacionadas.

Lo verás en diálogos de configuración, paneles de preferencias y pantallas de entrada de datos. Agrupa widgets visual y semánticamente, para que los usuarios vean qué va junto y qué no.

Objetivo: construir una ventana de configuración limpia usando LabelFrame para albergar Información Personal, Preferencias de Aplicación y Configuración de Notificaciones.

2 Prerrequisitos

LabelFrame es parte del módulo ttk de Tkinter, incluido con Python. Solo necesitas Python 3.7+ y la biblioteca estándar, sin paquetes adicionales.

Confirma tu versión:

python --version

3 Crear la Ventana de la Aplicación

Comienza creando una subclase de Tk para construir una ventana de configuración mínima. Esto te da un punto de entrada ordenado para componentes posteriores.

import tkinter as tk
from tkinter import ttk

class SettingsApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("Configuración de la Aplicación (Demostración LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        # Contenedor principal con relleno
        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

if __name__ == "__main__":
    app = SettingsApp()
    app.mainloop()

4 Primer LabelFrame: Información Personal

Crea un LabelFrame para “Información Personal”, luego añade dos campos etiquetados. Configura la cuadrícula para que los campos de entrada se expandan horizontalmente.

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        personal_frame = ttk.LabelFrame(
            parent,
            text="Información Personal",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(personal_frame, text="Nombre:").grid(row=0, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(personal_frame, text="Email:").grid(row=1, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        personal_frame.columnconfigure(1, weight=1)

5 Segundo LabelFrame: Preferencias de Aplicación

Añade un segundo LabelFrame para las preferencias. Usa Combobox para Tema e Idioma. Establecer state="readonly" evita ediciones de forma libre.

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        pref_frame = ttk.LabelFrame(parent, text="Preferencias de la Aplicación", padding="10")
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        ttk.Label(pref_frame, text="Tema:").grid(row=0, column=0, sticky=tk.W, pady=5)
        theme_combo = ttk.Combobox(pref_frame, values=["Claro", "Oscuro", "Sistema"], state="readonly")
        theme_combo.set("Claro")
        theme_combo.grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(pref_frame, text="Idioma:").grid(row=1, column=0, sticky=tk.W, pady=5)
        lang_combo = ttk.Combobox(pref_frame, values=["Inglés", "Español", "Francés", "Alemán"], state="readonly")
        lang_combo.set("Inglés")
        lang_combo.grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        pref_frame.columnconfigure(1, weight=1)

6 Tercer LabelFrame: Configuración de Notificaciones

Crea un tercer LabelFrame para los interruptores. Usa Checkbutton para opciones de estilo de Activado/Desactivado. Este frame no requiere columnas expansibles.

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        notif_frame = ttk.LabelFrame(parent, text="Configuración de Notificaciones", padding="10")
        notif_frame.pack(fill=tk.X)

        ttk.Checkbutton(notif_frame, text="Habilitar notificaciones por correo electrónico").grid(row=0, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Habilitar notificaciones de escritorio").grid(row=1, column=0, sticky=tk.W, pady=2)
        ttk.Checkbutton(notif_frame, text="Habilitar notificaciones de sonido").grid(row=2, column=0, sticky=tk.W, pady=2)

7 Ensamblar los Frames en init

Ahora llama a los tres métodos auxiliares desde __init__ para diseñar las secciones en orden.

    def __init__(self):
        super().__init__()
        self.title("Configuración de la Aplicación (Demostración LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

        self.create_personal_info_frame(main_container)
        self.create_preferences_frame(main_container)
        self.create_notification_frame(main_container)

8 Estilo y Relleno

El argumento padding añade espacio dentro de cada LabelFrame, lo que evita que el contenido toque el borde. Mantén los títulos cortos y descriptivos.

En macOS y Windows, la apariencia de LabelFrame sigue el tema nativo; en Linux con ttk puede variar. Evita depender de colores exactos entre plataformas.

9 Diseño: grid vs. pack

Dentro de un LabelFrame, grid es ideal para formularios etiquetados. Configura la columna 1 con weight=1 para que las entradas se estiren y llenen el ancho disponible. Para interruptores que no necesitan columnas, pack o grid de una sola fila funcionan bien.

Usa pady y sticky consistentemente para que las filas se alineen y se sientan cohesionadas. Sticky=EW asegura que los campos se expandan horizontalmente cuando la ventana cambia de tamaño.

10 Código Fuente Completo

Copia el ejemplo completo y ejecútalo para ver las tres secciones etiquetadas.

Nota: También tenemos un video tutorial para esta lección.

import tkinter as tk
from tkinter import ttk

class SettingsApp(tk.Tk):
    def __init__(self):
        super().__init__()

        # Configurar la ventana principal
        self.title("Configuración de la Aplicación (Demostración LabelFrame)")
        self.geometry("600x400")
        self.configure(bg='#f0f0f0')

        # Crear el contenedor principal con relleno
        main_container = ttk.Frame(self, padding="20")
        main_container.pack(fill=tk.BOTH, expand=True)

        # Crear y empaquetar la sección de información personal
        self.create_personal_info_frame(main_container)

        # Crear y empaquetar la sección de preferencias
        self.create_preferences_frame(main_container)

        # Crear y empaquetar la configuración de notificaciones
        self.create_notification_frame(main_container)

    def create_personal_info_frame(self, parent: ttk.Frame) -> None:
        """Crea un LabelFrame para la configuración de información personal."""
        personal_frame = ttk.LabelFrame(
            parent,
            text="Información Personal",
            padding="10"
        )
        personal_frame.pack(fill=tk.X, pady=(0, 10))

        # Crear y empaquetar los elementos del formulario
        ttk.Label(personal_frame, text="Nombre:").grid(row=0, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        ttk.Label(personal_frame, text="Email:").grid(row=1, column=0, sticky=tk.W, pady=5)
        ttk.Entry(personal_frame).grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        # Configurar pesos de columna de la cuadrícula
        personal_frame.columnconfigure(1, weight=1)

    def create_preferences_frame(self, parent: ttk.Frame) -> None:
        """Crea un LabelFrame para las preferencias de la aplicación."""
        pref_frame = ttk.LabelFrame(
            parent,
            text="Preferencias de la Aplicación",
            padding="10"
        )
        pref_frame.pack(fill=tk.X, pady=(0, 10))

        # Selección de tema
        ttk.Label(pref_frame, text="Tema:").grid(row=0, column=0, sticky=tk.W, pady=5)
        theme_combo = ttk.Combobox(
            pref_frame,
            values=["Claro", "Oscuro", "Sistema"],
            state="readonly"
        )
        theme_combo.set("Claro")
        theme_combo.grid(row=0, column=1, sticky=tk.EW, padx=(10, 0))

        # Selección de idioma
        ttk.Label(pref_frame, text="Idioma:").grid(row=1, column=0, sticky=tk.W, pady=5)
        lang_combo = ttk.Combobox(
            pref_frame,
            values=["Inglés", "Español", "Francés", "Alemán"],
            state="readonly"
        )
        lang_combo.set("Inglés")
        lang_combo.grid(row=1, column=1, sticky=tk.EW, padx=(10, 0))

        # Configurar pesos de columna de la cuadrícula
        pref_frame.columnconfigure(1, weight=1)

    def create_notification_frame(self, parent: ttk.Frame) -> None:
        """Crea un LabelFrame para la configuración de notificaciones."""
        notif_frame = ttk.LabelFrame(
            parent,
            text="Configuración de Notificaciones",
            padding="10"
        )
        notif_frame.pack(fill=tk.X)

        # Notificaciones por correo electrónico
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificaciones por correo electrónico"
        ).grid(row=0, column=0, sticky=tk.W, pady=2)

        # Notificaciones de escritorio
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificaciones de escritorio"
        ).grid(row=1, column=0, sticky=tk.W, pady=2)

        # Notificaciones de sonido
        ttk.Checkbutton(
            notif_frame,
            text="Habilitar notificaciones de sonido"
        ).grid(row=2, column=0, sticky=tk.W, pady=2)

if __name__ == "__main__":
    app = SettingsApp()
    app.mainloop()

Ejecutar con: python settings_app.py

11 Video y Conclusiones

Si prefieres ver, aquí tienes un breve recorrido sobre el uso de LabelFrame y el diseño básico.

Conclusión: LabelFrame organiza las secciones de la interfaz de usuario, les da un nombre y mejora la claridad. Usa relleno, títulos claros y pesos de columna para mantener los formularios consistentes y receptivos.