Bảng URL Routes ánh xạ path thân thiện tới file HTML
URL Routes

DINHDANH Creator · Bài AS04 · Cơ bản · Loạt Aura

URL và trang HTML
phải đi cùng nhau

Tránh lỗi “trang trắng / 404”: có file trang chưa đủ - còn phải có đường dẫn (route) khớp.

Mục tiêu: Hiểu cặp file HTML + đường dẫn URL; thêm route đúng nhãn UI; tự kiểm khi bị 404.

Thời lượng: ~12 phút · Trước: AS03, D02 · Sau: AS05

Đường dẫn Thêm Route Lưu Thư mục Lưu thay đổi routes.json

1. Sơ đồ cặp đôi

Code editor hiện các file HTML trang trong Creator
File trang HTML
Muốn mở: /gioi-thieu
├─ Cần file trang: ví dụ gioi-thieu.html (tab Thư mục)
└─ Cần dòng đường dẫn: /gioi-thieu → file đó (tab Đường dẫn)
Thiếu một trong hai → khách gặp trang lỗi / không tìm thấy

Giống có phòng họp nhưng chưa gắn biển số phòng ở hành lang: phòng có đó, khách vẫn lạc.

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
File trangFile HTML chứa nội dung trangTab Thư mục
Đường dẫn (route)Địa chỉ sau domain mà khách gõTab Đường dẫn
Thêm RouteNút thêm một cặp URL ↔ fileTab Đường dẫn
routes.jsonFile bản đồ đường dẫn (có trên UI)Tab Đường dẫn / Thư mục

3. Các bước

  1. Nhờ AI (Coder) tạo trang gioi-thieu.html - hoặc tạo file trong tab Thư mục.
  2. Mở tab Đường dẫn → nhấn Thêm Route.
  3. Đặt đường dẫn /gioi-thieu trỏ tới file vừa tạo → nhấn Lưu trong tab Đường dẫn.
  4. Toolbar → Lưu thay đổi.
  5. Mở link live …/gioi-thieu (không chỉ mở trong bản nháp).

4. Prompt mẫu

“Tạo trang Giới thiệu file gioi-thieu.html và thêm đường dẫn /gioi-thieu trỏ đúng file đó. Kiểm tra routes.json có dòng khớp. Mọi link điều hướng dùng URL tuyệt đối (helper getAbsoluteUrl), không dùng href bắt đầu bằng / mất tên-link.”

4b. Route lồng (tag / category) - bắt buộc khi có URL riêng

Trang chủ /tên-link/ có sẵn. Mọi địa chỉ khác (bài viết, thẻ, danh mục…) phải có dòng trong tab Đường dẫn. Ví dụ:

  • bai-viet-ve-ai → file chi tiết bài
  • tag/javascript → trang liệt kê theo thẻ
  • category/cong-nghe → trang liệt kê theo danh mục
Có dữ liệu bài trong Backend nhưng khách 404 → thường thiếu route, không phải “mất bài”. Khi xóa bài: xóa luôn đường dẫn tương ứng (nhờ AI / tab Đường dẫn).

4c. URL tuyệt đối - vì sao link dễ “ nhảy sai ” (SECTION URL TUYỆT ĐỐI)

Trang app có thẻ trỏ về gốc app. Link viết sai kiểu /gioi-thieu (có dấu / đầu) có thể mất tên-link và ra domain gốc. Link ../… cũng dễ lệch.

Cách viếtNên?
href="gioi-thieu" hoặc helper URL tuyệt đối✅ Đúng hướng
href="/gioi-thieu"❌ Dễ mất tên-link
href="gioi-thieu.html"❌ Khách cần slug route, không phải tên file

Prompt Coder: “dùng getAbsoluteUrl(slug) cho mọi chuyển trang”. Code mẫu đầy đủ: AM10.

5. So sánh

  • Webflow / Framer: cũng có “pages + slug” - cùng ý cặp đôi.
  • WordPress permalink: slug bài ≈ route; DINHDANH bạn thấy rõ file + bảng đường dẫn.

6. Giới hạn

Làm được

  • Nhiều trang / nhiều URL
  • AI tạo cả cặp nếu prompt rõ

Không

  • Chỉ tạo HTML chưa đủ lên URL đẹp
  • Route sai chính tả → 404 (X04)

7. Vấn đề thường gặp

Tình huốngXử lý
404 trên liveĐối chiếu tab Đường dẫn + đã Lưu thay đổi chưa
File có, route thiếuThêm Route → Lưu → Lưu thay đổi
Route trỏ sai fileSửa dòng route cho khớp tên file trong Thư mục
Link nhảy sai / mất tên-linkBỏ href="/…"; dùng URL tuyệt đối (mục 4c / AM10)

8. Checklist

  1. Có cả file HTML và dòng Đường dẫn?
  2. Đã Lưu (tab Đường dẫn) + Lưu thay đổi?
  3. Đã thử URL trên bản Hiện tại / live?

AS05 - Đăng nhập quản trị & vai trò

DINHDANH Creator · Loạt Aura · AS04