Hoàn thành bài "Bài 6: Kết Nối Sanity với Website HTML" trước để mở khoá bài này.Đến bài trước

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.

astro
---
import Layout from "../../layouts/Layout.astro";
import { client } from "../../lib/sanity";
export async function getStaticPaths() {
const products = await client.fetch(`*[_type == "product"]{ slug, title }`);
return products.map(p => ({
params: { slug: p.slug.current },
props: { slug: p.slug.current }
}));
}
const { slug } = Astro.props;
const product = await client.fetch(
`*[_type == "product" && slug.current == $slug][0]{
title, price, description, images, stock
}`,
{ slug }
);
---
<Layout title={product.title}>
<h1>{product.title}</h1>
<p>Giá: {product.price.toLocaleString("vi-VN")} đ</p>
<div set:html={product.description} />
<button id="add-to-cart" data-id={slug}>Thêm vào giỏ hàng</button>
</Layout>

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

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ỏ.

javascript
function addToCart(productId, productName, price) {
const cart = JSON.parse(localStorage.getItem("cart") || "[]");
const existing = cart.find(item => item.id === productId);
if (existing) {
existing.quantity += 1;
} else {
cart.push({ id: productId, name: productName, price: price, quantity: 1 });
}
localStorage.setItem("cart", JSON.stringify(cart));
updateCartCount();
alert("Đã thêm " + productName + " vào giỏ hàng");
}
function updateCartCount() {
const cart = JSON.parse(localStorage.getItem("cart") || "[]");
const total = cart.reduce((sum, item) => sum + item.quantity, 0);
document.getElementById("cart-count").textContent = total;
}
document.getElementById("add-to-cart").addEventListener("click", (e) => {
const btn = e.currentTarget;
addToCart(btn.dataset.id, "{{product.title}}", {{product.price}});
});

Để 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.

markup
<form action="https://formspree.io/f/yourFormId" method="POST">
<input type="text" name="name" placeholder="Họ tên" required>
<input type="email" name="email" placeholder="Email" required>
<input type="tel" name="phone" placeholder="Số điện thoại">
<textarea name="message" placeholder="Nội dung cần tư vấn" required></textarea>
<input type="hidden" name="_subject" value="Liên hệ mới từ website">
<button type="submit">Gửi liên hệ</button>
</form>

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.

Luyện tập sau buổi học

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.

0/1
Đã trả lời · 0/1