Làm chủ htmx 2.0: Xây dựng Ứng dụng Web Tương tác Không cần JavaScript Framework

Bối cảnh & Lý do: JavaScript Framework Fatigue là Có thật

Sau ba tháng xây dựng dashboard nội bộ cho team, tôi nhìn chằm chằm vào một bundle JavaScript 2MB chỉ làm đúng ba việc: fetch dữ liệu, render danh sách và hiển thị modal. Cây component React đã phình to đến mức cần họp cả team lại mới hiểu được. Đó là lúc tôi thực sự bắt đầu tìm hiểu htmx.

htmx không phải là ý tưởng mới. Đây là cách tiếp cận hiện đại với hypermedia — kiến trúc web nguyên bản. Server của bạn trả về các HTML fragment trực tiếp thay vì gửi một ứng dụng JavaScript xuống trình duyệt. Trình duyệt chỉ cập nhật đúng phần trang đã thay đổi. Không cần quản lý state, không cần reconcile virtual DOM, không có lỗi hydration.

Phiên bản 2.0 (phát hành giữa năm 2024) đã làm sạch API, loại bỏ các shortcut bị deprecated và thắt chặt các cài đặt bảo mật mặc định. Nếu bạn đã dùng 1.x, hầu hết các attribute đều giống hệt — việc nâng cấp mất chưa đến một tiếng. Bắt đầu từ đầu? 2.0 là điểm khởi đầu đúng đắn.

Khi nào htmx thực sự phát huy tác dụng?

  • Backend của bạn đã render HTML sẵn (Django, Flask, Rails, Laravel, Go templates)
  • Bạn cần tính tương tác — tìm kiếm khi gõ, chỉnh sửa inline, bảng phân trang — mà không muốn cam kết với một SPA đầy đủ
  • Team của bạn hiểu HTML và code backend tốt hơn là TypeScript và hệ sinh thái npm

Cả hai dự án tôi đã ship với htmx vẫn đang chạy. Thời gian tải lần đầu giảm khoảng 60% khi chúng tôi loại bỏ bundle 2MB đó. Developer mới đọc được codebase chỉ trong một buổi chiều thay vì mất cả tuần chiến đấu với config webpack. Không phải lời quảng cáo — kết quả đo thực tế, hai lần triển khai production riêng biệt.

Cài đặt: Khởi động htmx 2.0

Cách nhanh nhất là thêm thẻ CDN vào <head>:

<!-- htmx 2.0 từ CDN -->
<script src="https://unpkg.com/[email protected]/dist/htmx.min.js"></script>

Với môi trường production, hãy ghim phiên bản và tự phục vụ file — sự cố CDN hiếm nhưng vẫn xảy ra:

npm install [email protected]
# Sao chép file đã minify vào thư mục static assets của bạn
cp node_modules/htmx.org/dist/htmx.min.js static/js/htmx.min.js

Bất kỳ server nào render HTML đều hoạt động như backend. Đây là cài đặt Flask tối giản bao gồm tất cả các ví dụ bên dưới:

from flask import Flask, render_template_string, request

app = Flask(__name__)

BASE_HTML = """
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>htmx Demo</title>
    <script src="/static/js/htmx.min.js"></script>
</head>
<body>{{ content }}</body>
</html>
"""

@app.route("/")
def index():
    content = '<button hx-get="/hello" hx-target="#result">Bấm vào đây</button><div id="result"></div>'
    return render_template_string(BASE_HTML, content=content)

@app.route("/hello")
def hello():
    return "<p>Server phản hồi — không cần viết JavaScript.</p>"

if __name__ == "__main__":
    app.run(debug=True)

Chạy với python app.py, mở http://localhost:5000, nhấn nút. Endpoint /hello trả về một HTML fragment. htmx đưa nó vào #result. Đó là toàn bộ mô hình hoạt động.

Cấu hình: Các Attribute Cốt lõi và Mẫu Hypermedia

htmx hoạt động thông qua các HTML attribute. Bạn khai báo ý định ngay trong markup — không cần event listener, không cần gọi fetch.

Bốn Attribute Bạn Sẽ Dùng Thường xuyên

<!-- GET request khi click, thay thế nội dung #results -->
<button
  hx-get="/api/items"
  hx-target="#results"
  hx-swap="innerHTML">
  Tải dữ liệu
</button>

<!-- POST form không tải lại trang, thêm item mới vào cuối danh sách -->
<form hx-post="/api/items" hx-target="#item-list" hx-swap="beforeend">
  <input name="title" placeholder="Nhập tên mới" />
  <button type="submit">Thêm</button>
</form>

<div id="results"></div>
<ul id="item-list"></ul>

hx-swap kiểm soát vị trí HTML phản hồi được chèn vào. Các giá trị hữu ích nhất:

  • innerHTML — thay thế nội dung bên trong target (mặc định)
  • outerHTML — thay thế chính phần tử target
  • beforeend — thêm vào bên trong target, sau phần tử con cuối cùng (lý tưởng cho danh sách)
  • delete — xóa target sau khi nhận phản hồi thành công (tuyệt vời cho luồng “xóa dòng”)

Custom Trigger cho Tìm kiếm Khi Gõ

Button kích hoạt theo click và input kích hoạt theo change theo mặc định. Override bằng hx-trigger:

<!-- Kích hoạt tìm kiếm 400ms sau khi người dùng ngừng gõ -->
<input
  type="search"
  name="q"
  hx-get="/search"
  hx-target="#search-results"
  hx-trigger="input changed delay:400ms"
  placeholder="Tìm kiếm..."
/>
<div id="search-results"></div>

delay:400ms debounce request — không có gì kích hoạt cho đến khi người dùng dừng lại. Modifier changed bỏ qua hoàn toàn request nếu giá trị chưa thực sự thay đổi, chẳng hạn khi người dùng nhấn phím mũi tên mà không sửa text. Route Flask tương ứng:

@app.route("/search")
def search():
    query = request.args.get("q", "").lower()
    items = [i for i in ["docker", "kubernetes", "nginx", "redis"] if query in i]
    if not items:
        return "<p>Không có kết quả.</p>"
    return "".join(f"<li>{item}</li>" for item in items)

Out-of-Band Swaps: Cập nhật Nhiều Vùng DOM Cùng lúc

Một request htmx chỉ có thể target một phần tử — giới hạn này thường gây bối rối cho người mới. Out-of-band (OOB) swaps phá vỡ điều đó. Bất kỳ phần tử nào trong response được đánh dấu hx-swap-oob="true" sẽ được swap vào phần tử trùng ID, song song với việc cập nhật target chính:

@app.route("/api/items", methods=["POST"])
def add_item():
    title = request.form.get("title", "")
    # Lưu vào DB, lấy số lượng đã cập nhật...
    new_count = 42

    # Phản hồi chính: list item mới đi vào hx-target
    main = f"<li>{title}</li>"

    # OOB: đồng thời cập nhật badge đếm ở chỗ khác trên trang
    oob = f'<span id="item-count" hx-swap-oob="true">{new_count} mục</span>'

    return main + oob

Progressive Enhancement với hx-boost

Thêm hx-boost="true" vào bất kỳ container nào và htmx sẽ chuyển đổi mọi anchor và form bên trong thành AJAX request. URL được cập nhật, nút back hoạt động, tiêu đề trang thay đổi. Nó hoạt động như điều hướng trình duyệt thông thường — chỉ nội dung body được swap:

<nav hx-boost="true">
  <a href="/dashboard">Dashboard</a>
  <a href="/settings">Cài đặt</a>
</nav>

Cách nhanh nhất để thêm điều hướng kiểu SPA vào ứng dụng multi-page hiện có. Không cần thư viện routing. Không cần hệ thống component.

Kiểm tra & Giám sát: Debug Trước Khi Deploy

htmx thực hiện công việc một cách im lặng theo mặc định — tốt cho production, nhưng gây bực bội khi có gì đó không hoạt động như mong đợi.

Bật Logging htmx Trong Quá trình Phát triển

Thêm đoạn này vào trang của bạn khi debug:

<script>
  htmx.logAll();
</script>

Mọi lifecycle event của htmx đều xuất hiện trong console trình duyệt: htmx:beforeRequest, htmx:afterRequest, htmx:beforeSwap và htmx:afterSwap. Chín trong mười trường hợp, kiểm tra những thứ này là đủ — bạn thấy chính xác request nào đã được gửi, phản hồi là gì và phần tử nào được target.

Phân biệt Request htmx với Request Toàn trang

Mọi request htmx đều bao gồm header HX-Request: true. Dùng nó để trả về fragment cho các lệnh gọi htmx và trang đầy đủ cho truy cập URL trực tiếp:

@app.route("/dashboard")
def dashboard():
    is_htmx = request.headers.get("HX-Request")
    if is_htmx:
        return render_template("dashboard_content.html")  # chỉ fragment
    return render_template("dashboard.html")  # trang đầy đủ

Trong tab network, lọc theo Fetch/XHR để tách riêng các request htmx. Mỗi request nên trả về một fragment HTML nhỏ — không phải toàn bộ trang. Thấy phản hồi HTML đầy đủ cho các lệnh gọi htmx? Đoạn kiểm tra ở trên chính là thứ bạn cần.

Response Header để Server Điều khiển Client

Một số response header cho phép server điều hướng hành vi client mà không cần viết JavaScript:

from flask import make_response

@app.route("/api/items/<int:item_id>", methods=["DELETE"])
def delete_item(item_id):
    # Xóa khỏi DB...
    response = make_response("", 200)
    response.headers["HX-Redirect"] = "/items"   # điều hướng đầy đủ sau khi xóa
    response.headers["HX-Trigger"] = "itemDeleted"  # kích hoạt JS event trên client
    return response

HX-Redirect kích hoạt điều hướng đầy đủ. HX-Trigger kích hoạt một JavaScript event trên client — đóng modal, làm mới counter, bất kỳ thứ gì cần xảy ra mà không gắn logic đó vào body phản hồi.

Danh sách Kiểm tra Trước khi Ra mắt

  • Xóa các lệnh gọi htmx.logAll() trước khi deploy — chúng tạo noise trong console production
  • Xác nhận server trả về fragment (không phải trang đầy đủ) khi có HX-Request
  • Kiểm tra với JavaScript bị tắt: form nên submit bình thường, link nên điều hướng (progressive enhancement cơ bản)
  • Xác nhận các trang dùng hx-boost cập nhật lịch sử trình duyệt đúng cách bằng cách thử nút back
  • Thêm CSRF token toàn cục nếu backend của bạn yêu cầu:
<script>
  document.addEventListener("DOMContentLoaded", function () {
    htmx.config.defaultHeaders["X-CSRFToken"] = document.cookie
      .split("; ")
      .find(row => row.startsWith("csrftoken="))
      ?.split("=")[1];
  });
</script>

Một thay đổi bảo mật trong htmx 2.0 đáng chú ý: htmx.config.selfRequestsOnly giờ mặc định là true, có nghĩa htmx chỉ xử lý các request đến cùng origin. Đang chuyển từ dự án 1.x có gọi các endpoint cross-origin? Đó chính là cài đặt đã thay đổi.

Debug htmx không giống gì với debug một ứng dụng React. Không cần trace source map. Không cần gỡ rối cây component. Không có stack trace lỗi hydration mismatch. Mở tab network, theo dõi các request, đọc HTML. Nếu có gì đó hỏng, bạn sẽ tìm ra trong chưa đầy hai phút. Ship một dự án với htmx và bạn sẽ thôi đi tìm framework tiếp theo để học.

Share: