Estilos y UX Final

La funcionalidad esta completa. Ahora le damos vida visual a la app con CSS moderno (sin frameworks), animaciones para las transiciones de HTMX y mejoras de accesibilidad.

Archivo de Estilos

Creamos static/styles.css. Usamos variables CSS para mantener consistencia:

:root {
    --color-bg: #1a1a2e;
    --color-surface: #16213e;
    --color-primary: #0f3460;
    --color-accent: #e94560;
    --color-text: #eee;
    --color-muted: #888;
    --radius: 8px;
    --shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
}

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}

body {
    font-family: system-ui, -apple-system, sans-serif;
    background: var(--color-bg);
    color: var(--color-text);
    line-height: 1.6;
    min-height: 100vh;
}

Layout del Contenedor

.container {
    max-width: 600px;
    margin: 2rem auto;
    padding: 0 1rem;
}

.container h1 {
    text-align: center;
    margin-bottom: 1.5rem;
    font-size: 2rem;
    color: var(--color-accent);
}

Formulario de Creacion

.todo-form {
    display: flex;
    gap: 0.5rem;
    margin-bottom: 1rem;
}

.todo-form input[type="text"] {
    flex: 1;
    padding: 0.75rem 1rem;
    border: 2px solid var(--color-primary);
    border-radius: var(--radius);
    background: var(--color-surface);
    color: var(--color-text);
    font-size: 1rem;
    outline: none;
    transition: border-color 0.2s;
}

.todo-form input[type="text"]:focus {
    border-color: var(--color-accent);
}

.todo-form button {
    padding: 0.75rem 1.5rem;
    border: none;
    border-radius: var(--radius);
    background: var(--color-accent);
    color: white;
    font-size: 1rem;
    cursor: pointer;
    transition: opacity 0.2s;
}

.todo-form button:hover {
    opacity: 0.85;
}

Barra de Busqueda

.search-bar {
    position: relative;
    margin-bottom: 1rem;
}

.search-bar input[type="search"] {
    width: 100%;
    padding: 0.6rem 1rem;
    border: 2px solid var(--color-primary);
    border-radius: var(--radius);
    background: var(--color-surface);
    color: var(--color-text);
    font-size: 0.9rem;
    outline: none;
    transition: border-color 0.2s;
}

.search-bar input[type="search"]:focus {
    border-color: var(--color-accent);
}

Filtros

.todo-filters {
    display: flex;
    gap: 0.5rem;
    margin-bottom: 1rem;
}

.filter-btn {
    padding: 0.4rem 1rem;
    border: 1px solid var(--color-primary);
    border-radius: var(--radius);
    background: transparent;
    color: var(--color-muted);
    cursor: pointer;
    transition: all 0.2s;
}

.filter-btn:hover {
    color: var(--color-text);
    border-color: var(--color-accent);
}

.filter-btn.active {
    background: var(--color-primary);
    color: var(--color-text);
    border-color: var(--color-accent);
}

Items de Todo

.todo-item {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    padding: 0.75rem 1rem;
    margin-bottom: 0.5rem;
    background: var(--color-surface);
    border-radius: var(--radius);
    box-shadow: var(--shadow);
    transition: opacity 0.3s ease, transform 0.3s ease;
}

.todo-item:hover {
    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
}

.todo-item input[type="checkbox"] {
    width: 1.2rem;
    height: 1.2rem;
    cursor: pointer;
    accent-color: var(--color-accent);
}

.todo-title {
    flex: 1;
    font-size: 1rem;
}

.todo-item.completed .todo-title {
    text-decoration: line-through;
    opacity: 0.5;
}

.todo-actions {
    display: flex;
    gap: 0.25rem;
}

Botones de Accion

.btn-edit,
.btn-delete,
.btn-save,
.btn-cancel,
.btn-clear {
    padding: 0.3rem 0.6rem;
    border: none;
    border-radius: 4px;
    cursor: pointer;
    font-size: 0.8rem;
    transition: opacity 0.2s;
}

.btn-edit {
    background: var(--color-primary);
    color: var(--color-text);
}

.btn-delete {
    background: var(--color-accent);
    color: white;
}

.btn-save {
    background: #2ecc71;
    color: white;
}

.btn-cancel {
    background: var(--color-muted);
    color: white;
}

.btn-clear {
    background: transparent;
    border: 1px solid var(--color-muted);
    color: var(--color-muted);
    margin-top: 1rem;
    padding: 0.5rem 1rem;
}

.btn-edit:hover,
.btn-delete:hover,
.btn-save:hover,
.btn-cancel:hover,
.btn-clear:hover {
    opacity: 0.8;
}

Input de Edicion Inline

.todo-item.editing {
    flex-wrap: wrap;
}

.todo-item.editing form {
    display: flex;
    gap: 0.5rem;
    width: 100%;
}

.edit-input {
    flex: 1;
    padding: 0.5rem;
    border: 2px solid var(--color-accent);
    border-radius: 4px;
    background: var(--color-bg);
    color: var(--color-text);
    font-size: 1rem;
    outline: none;
}

Loading Indicator

HTMX agrega/remueve la clase htmx-request al elemento que disparo el request. Usamos htmx-indicator para mostrar un spinner:

.htmx-indicator {
    display: none;
    color: var(--color-muted);
    font-size: 0.85rem;
}

.htmx-request .htmx-indicator,
.htmx-request.htmx-indicator {
    display: inline-block;
}

Cuando HTMX hace un request, el elemento con hx-indicator se hace visible. Cuando termina, se oculta.

Animaciones HTMX

HTMX proporciona clases CSS en cada fase del swap que podemos aprovechar:

Clase	Momento
htmx-request	Durante el request HTTP
htmx-swapping	Justo antes del swap
htmx-settling	Justo despues del swap
htmx-added	Elemento recien insertado

Animacion al Agregar

.todo-item.htmx-added {
    opacity: 0;
    transform: translateY(-10px);
}

.todo-item.htmx-settling {
    opacity: 1;
    transform: translateY(0);
    transition: opacity 0.3s ease, transform 0.3s ease;
}

El item aparece con un fade-in de arriba hacia abajo.

Animacion al Eliminar

.todo-item.htmx-swapping {
    opacity: 0;
    transform: translateX(-20px);
    transition: opacity 0.3s ease, transform 0.3s ease;
}

El item desaparece deslizandose a la izquierda.

Estado Vacio

.empty-state {
    text-align: center;
    padding: 2rem;
    color: var(--color-muted);
}

.empty-state p {
    font-size: 1.1rem;
}

Contador y Limpiar

.todo-count {
    text-align: center;
    color: var(--color-muted);
    font-size: 0.9rem;
    margin-top: 1rem;
}

Responsividad

@media (max-width: 480px) {
    .container {
        margin: 1rem auto;
    }

    .container h1 {
        font-size: 1.5rem;
    }

    .todo-form {
        flex-direction: column;
    }

    .todo-actions {
        flex-direction: column;
    }

    .todo-filters {
        flex-wrap: wrap;
        justify-content: center;
    }
}

En pantallas pequenas el formulario se apila verticalmente.

Accesibilidad

Labels y ARIA

Actualizamos los templates para incluir atributos de accesibilidad:

templ TodoForm() {
    <form hx-post="/todos"
          hx-target="#todo-list"
          hx-swap="beforeend"
          hx-on::after-request="this.reset()"
          aria-label="Crear nueva tarea">
        <div class="todo-form">
            <label for="new-todo" class="sr-only">
                Nueva tarea
            </label>
            <input type="text"
                   id="new-todo"
                   name="title"
                   placeholder="Nueva tarea..."
                   required
                   autocomplete="off"
                   aria-describedby="todo-help"/>
            <button type="submit">Agregar</button>
        </div>
    </form>
}

Clase sr-only

Para labels visualmente ocultos pero accesibles a lectores de pantalla:

.sr-only {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border: 0;
}

ARIA en el Checkbox

<input type="checkbox"
       if todo.Completed {
           checked
       }
       aria-label={ "Marcar " + todo.Title + " como completada" }
       hx-put={ fmt.Sprintf("/todos/%d/toggle", todo.ID) }
       hx-target={ fmt.Sprintf("#todo-%d", todo.ID) }
       hx-swap="outerHTML"/>

Focus Management

Cuando se crea un todo, el foco debe volver al input:

.todo-form input[type="text"]:focus-visible {
    outline: 2px solid var(--color-accent);
    outline-offset: 2px;
}

button:focus-visible {
    outline: 2px solid var(--color-accent);
    outline-offset: 2px;
}

Resultado Final

La app completa se ve asi:

• Header con el titulo “Todo List”
• Input de busqueda con indicador de carga
• Botones de filtro: Todos | Activos | Completados
• Formulario para agregar nuevas tareas
• Lista de tareas con checkbox, titulo y botones
• Tareas completadas tachadas con opacidad reducida
• Contador de pendientes al pie
• Boton para limpiar completados
• Animaciones suaves al agregar y eliminar
• Tema oscuro con acentos en rojo

Todo funciona sin JavaScript manual. Los estilos complementan a HTMX con transiciones CSS que hacen que los swaps se sientan naturales.

Resumen

Aspecto	Tecnica
Variables CSS	Custom properties en :root
Animaciones	Clases HTMX (htmx-added, htmx-swapping)
Indicadores	htmx-indicator con CSS display
Accesibilidad	Labels, ARIA, focus-visible, sr-only
Responsividad	Media queries, flexbox
Tema	Dark theme con variables

---

<— Capitulo 12: Filtros y Busqueda | Capitulo 14: Deploy —>