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.
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-headerscho request ghi (Django có sẵn middleware CSRF). - Template tự escape (autoescape) — không đánh dấu
|safecho dữ liệu người dùng. - Alpine.js cho dropdown, modal, tab — không cần round-trip.
| Chọn HTMX khi | Chọn React khi |
|---|---|
| CRUD, dashboard, back-office, form nhiều bước, team chủ yếu Python | Tươ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ắc | Ví dụ |
|---|---|
| Thẻ HTML đúng nghĩa | <button> cho hành động, <a> cho điều hướng |
| Label cho mọi input | Lỗi liên kết bằng aria-describedby, aria-invalid |
| Bàn phím | Tab tới mọi thứ, focus nhìn thấy, modal bẫy focus và đóng bằng Esc |
| Contrast ≥ 4.5:1 | Tránh chữ xám nhạt trên nền trắng |
| Nội dung động | aria-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, fontdisplay: swap. - Asset có hash →
Cache-Control: immutabledà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
(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
-
htmxTài liệu HTMXDocs
-
Hypermedia SystemsSách miễn phí về HTMX và hypermediaSách
-
Alpine.jsJS nhẹ cho tương tác cục bộDocs
-
WAI-ARIA Authoring PracticesMẫu accessibilityGuide
-
web.dev — Web VitalsLCP, INP, CLSDocs
✅ 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