Giới thiệu
Ở bài trước, chúng ta đã tạo trang danh sách sản phẩm lấy dữ liệu động từ Sanity. Bài này sẽ nâng cấp trải nghiệm bằng cách xây dựng trang chi tiết cho từng sản phẩm — nơi khách hàng xem được mô tả đầy đủ, hình ảnh lớn, giá bán và thực hiện hành động mua hàng. Đây là trang quan trọng nhất trong hành trình chuyển đổi từ người xem sang khách hàng thực sự.
Mục tiêu bài này gồm 3 phần: tạo route động `/products/[slug]` để render chi tiết sản phẩm, tích hợp nút "Thêm vào giỏ hàng" lưu vào localStorage, và xây dựng form liên hệ đơn giản gửi thông tin đến email hoặc Sanity.
Cấu trúc route động trong Astro
Vì dự án dùng Astro, ta tạo file `[slug].astro` trong thư mục `src/pages/products/`. File này sẽ tự động nhận mọi đường dẫn dạng `/products/abc`, `/products/xyz` và truy vấn Sanity theo slug tương ứng.
Lưu ý hàm `getStaticPaths` — đây là cách Astro build ra các trang tĩnh từ dữ liệu Sanity. Mỗi sản phẩm sẽ trở thành một file HTML riêng trong thư mục `dist/products/`.
![sơ đồ luồng từ URL đến render trang chi tiết sản phẩm — User truy cập URL → Astro match route [slug] → gọi getStaticPaths → Sanity trả về sản phẩm → render HTML tĩnh](https://cdn.sanity.io/images/hs5ychob/production/9e12256891a94b946441a4513b8a36c13ada277b-1344x768.jpg?w=1200&q=75&auto=format&fit=max)
Giỏ hàng với localStorage
Vì đây là static site, không có backend session, nên giỏ hàng lưu trực tiếp trong `localStorage` của trình duyệt. Cách này đơn giản, không cần server, phù hợp với website bán hàng nhỏ.
Để hiển thị số lượng sản phẩm trong giỏ ở header, gọi `updateCartCount()` khi trang load xong.
Form liên hệ đơn giản
Form liên hệ có nhiều cách xử lý: dùng dịch vụ như Formspree, Netlify Forms, hoặc lưu vào Sanity như một document mới. Cách nhanh nhất cho static site là dùng Formspree — chỉ cần đăng ký endpoint là form chạy được.
Nếu muốn lưu liên hệ vào Sanity để quản lý tập trung, tạo schema mới kiểu `contactSubmission` và dùng client mutation từ phía client-side — nhưng cần token có quyền ghi, không khuyến khích để lộ token public.
Lỗi thường gặp
Lỗi phổ biến nhất là quên gọi `getStaticPaths` khiến Astro báo lỗi không build được các trang con. Lỗi thứ hai là đặt logic giỏ hàng trong server-side script mà không có DOM — phải tách phần xử lý giỏ hàng vào thẻ `<script>` ở phần template. Cuối cùng, khi dùng `set:html` để render mô tả sản phẩm từ Sanity, cần đảm bảo editor Sanity không nhập HTML nguy hiểm — nên dùng field kiểu Portable Text thay vì chuỗi HTML thuần.
Tổng kết
Trang chi tiết sản phẩm là nơi quyết định khách hàng có mua hàng hay không. Kết hợp route động của Astro, giỏ hàng localStorage và form liên hệ, ta đã có một luồng thương mại điện tử cơ bản chạy hoàn toàn trên static site. Bài sau sẽ xây trang giỏ hàng và trang thanh toán để hoàn thiện hành trình mua sắm.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.