Fullstack Python
Trang chủ / Module 13
🎨 Module 13 / 19 · 4 ngày 📅 Tuần 9-10 ●●○○ Trung bình

HTMX & server-rendered UI, giao diện chuyên nghiệp, accessibility, hiệu năng

Con đường thứ hai cho fullstack Python: HTMX + Alpine với template Django/Jinja2 (giao diện động không cần SPA), cùng nền tảng giao diện chung — Tailwind và design token, accessibility chuẩn WCAG, đa ngôn ngữ, Core Web Vitals và tối ưu tải trang.

HTMXDjango/Jinja templatesTailwindAccessibilityCore Web Vitals
📌 Vì sao module này quan trọng

Không phải màn hình nào cũng cần React. Nhiều team Python giao sản phẩm nhanh hơn hẳn với HTMX: server trả HTML, trình duyệt thay từng phần trang — ít JavaScript, ít trạng thái trùng lặp, một ngôn ngữ chính. Biết cả hai cách và chọn đúng cho từng màn hình là dấu hiệu senior. Phần giao diện, accessibility và hiệu năng thì áp dụng cho mọi cách làm và tạo khác biệt lớn khi nhà tuyển dụng mở portfolio.

🎯 Mục tiêu học tập

  • Xây giao diện động bằng HTMX + template Django/Jinja2 (partial, swap, out-of-band)
  • Dùng Alpine.js cho tương tác cục bộ; biết khi nào chọn HTMX hay React
  • Làm giao diện chuyên nghiệp với Tailwind, responsive, dark mode, đủ trạng thái
  • Đạt accessibility cơ bản và đa ngôn ngữ
  • Đo và cải thiện Core Web Vitals

HTMX: HTML qua lại thay vì JSON

<!-- Template: tìm kiếm có debounce, server trả về một đoạn HTML -->
<input type="search" name="q" hx-get="/tasks/search" hx-trigger="input changed delay:300ms"
       hx-target="#results" hx-indicator="#spinner" aria-label="Tìm task">
<div id="results">{% include "tasks/_list.html" %}</div>

<!-- Đổi trạng thái task, chỉ thay đúng một thẻ -->
<button hx-post="/tasks/{{ task.id }}/complete" hx-target="closest .task-card" hx-swap="outerHTML">Hoàn thành</button>
# FastAPI + Jinja2 (Django tương tự với view trả template partial)
@router.get("/tasks/search", response_class=HTMLResponse)
async def search(request: Request, q: str, session: SessionDep, user: UserDep):
    tasks = await repo.search(session, user.org_id, q)
    template = "tasks/_list.html" if request.headers.get("HX-Request") else "tasks/index.html"
    return templates.TemplateResponse(request, template, {"tasks": tasks})
  • CSRF: gửi token qua header hx-headers cho request ghi (Django có sẵn middleware CSRF).
  • Template tự escape (autoescape) — không đánh dấu |safe cho dữ liệu người dùng.
  • Alpine.js cho dropdown, modal, tab — không cần round-trip.
Chọn HTMX khiChọn React khi
CRUD, dashboard, back-office, form nhiều bước, team chủ yếu PythonTương tác phức tạp (kéo thả, editor, realtime cộng tác), offline, có mobile/đối tác dùng chung API

Giao diện chuyên nghiệp

  • Tailwind v4 với token (màu thương hiệu, thang xám, khoảng cách 4/8px, radius); tối đa 2 font; chữ thân ≥ 16px.
  • Component headless có accessibility sẵn (shadcn/ui, Radix, React Aria cho React).
  • Responsive mobile-first, dark mode; mọi màn dữ liệu có loading (skeleton), empty (hướng dẫn hành động đầu tiên), error (thử lại).

Accessibility và đa ngôn ngữ

Quy tắcVí dụ
Thẻ HTML đúng nghĩa<button> cho hành động, <a> cho điều hướng
Label cho mọi inputLỗi liên kết bằng aria-describedby, aria-invalid
Bàn phímTab tới mọi thứ, focus nhìn thấy, modal bẫy focus và đóng bằng Esc
Contrast ≥ 4.5:1Tránh chữ xám nhạt trên nền trắng
Nội dung độngaria-live cho kết quả HTMX swap, toast

Đa ngôn ngữ: Django i18n (gettext, makemessages) hoặc Babel cho Jinja2; react-i18next/FormatJS ở React; định dạng ngày/số bằng Intl (client) và Babel (server). Lưu UTC, hiển thị theo múi giờ người dùng.

Core Web Vitals

  • LCP ≤ 2.5s: TTFB tốt (cache, không N+1), ảnh hero có fetchpriority="high", WebP/AVIF đúng kích thước, CSS không chặn render.
  • INP ≤ 200ms: giảm JS, code splitting, tránh handler nặng, trì hoãn script bên thứ ba.
  • CLS ≤ 0.1: ảnh có width/height, giữ chỗ cho nội dung tải sau, font display: swap.
  • Asset có hash → Cache-Control: immutable dài hạn; nén Brotli ở Nginx/CDN; WhiteNoise cho static file Django đơn giản.
  • Đo bằng Lighthouse (lab) và thư viện web-vitals (người dùng thật).

🏋️ Bài tập thực hành

Hai giao diện, một backend

(1) Xây trang "Báo cáo hoạt động" bằng HTMX + Jinja2/Django template: lọc, tìm kiếm debounce, phân trang, thao tác nhanh, có CSRF. (2) So sánh số dòng code và thời gian làm với cùng màn hình bằng React. (3) Bộ token + component dùng chung, responsive 360-1440px, dark mode. (4) Lighthouse Accessibility ≥ 95 trên 3 trang chính, dùng được bằng bàn phím. (5) Hai ngôn ngữ vi/en. (6) Báo cáo Web Vitals trước/sau tối ưu đưa vào README.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Xây được màn hình động bằng HTMX có CSRF và autoescape
  • Chọn HTMX hay React có lý do cho từng màn hình
  • Lighthouse a11y ≥ 95, dùng được bằng bàn phím, 2 ngôn ngữ
  • Có số liệu Web Vitals trước/sau