Hướng dẫn dùng trang Danh sách truyện trên Vinahentai: lọc, sắp xếp và nhập số trang để đi nhanh

1. Trang Danh sách dùng để làm gì?

Hãy dùng trang Danh sách khi bạn rơi vào một trong các trường hợp sau:

• Bạn chưa có từ khóa cụ thể nhưng muốn xem truyện mới được cập nhật gần đây
• Bạn muốn sắp theo lượt xem để tìm truyện phổ biến
• Bạn muốn duyệt kho truyện theo chữ cái A-Z hoặc Z-A
• Bạn muốn xem riêng truyện đã hoàn thành hoặc đang ra
• Bạn đang ở một trang sâu và muốn nhảy thẳng tới một trang khác bằng số trang

Nếu bạn cần lọc theo nhiều thể loại cùng lúc hoặc kết hợp từ khóa với tag, hãy xem thêm bài hướng dẫn tìm kiếm thường và nâng cao. Trang Danh sách hiện không phải nơi mạnh nhất cho lọc đa điều kiện.

2. Những truyện nào được đưa vào danh sách?

Theo loader của route /danh-sach, danh sách hiện chỉ lấy những truyện thỏa các điều kiện kỹ thuật sau:

• status = APPROVED: chỉ lấy truyện đã được duyệt
• contentType = MANGA hoặc null: không dùng cho các loại content ngoài phạm vi này
• chapters >= 1: chỉ hiển thị truyện đã có ít nhất 1 chương

Vì vậy nếu bạn không thấy một truyện mới tạo nhưng chưa có chương, đó thường là vì truyện đó chưa vượt qua điều kiện chapters >= 1, chứ không phải do giao diện lỗi.

Mỗi trang hiện hiển thị 40 truyện. Đây cũng là lý do component grid luôn khá dày, phù hợp cho việc duyệt nhanh số lượng lớn.

3. Hiểu đúng các kiểu sắp xếp theo thời gian, view và alphabet

Ở góc trên bên phải của trang là dropdown sắp xếp. Đây là chỗ nhiều người hay gọi chung là “bộ lọc theo thời gian”, nhưng chính xác hơn thì đây là sắp xếp, không phải filter. Code hiện map từng lựa chọn như sau:

• Mới cập nhật → updatedAt giảm dần
• Mới nhất → createdAt giảm dần
• Cũ nhất → updatedAt tăng dần
• Xem nhiều → viewNumber giảm dần
• A-Z → title tăng dần
• Z-A → title giảm dần

Phân biệt Mới cập nhật và Mới nhất

Đây là điểm quan trọng nhất của trang Danh sách:

• Mới cập nhật phù hợp khi bạn muốn xem bộ nào vừa ra chương mới hoặc vừa được động vào dữ liệu gần đây.
• Mới nhất phù hợp khi bạn muốn xem truyện nào mới được thêm vào hệ thống.

Nếu mục tiêu của bạn là săn chương mới, hãy ưu tiên Mới cập nhật. Nếu mục tiêu là xem kho mới đăng, hãy dùng Mới nhất.

4. Cách dùng bộ lọc tình trạng

Bên phải danh sách có card “Tình trạng” với 2 checkbox:

• Chưa hoàn thành
• Đã hoàn thành

Sau khi tick xong, bạn cần bấm nút Lọc. Khác với một số UI tự lọc ngay khi tick, trang Danh sách hiện gom lựa chọn rồi chỉ update URL khi bạn bấm nút.

Logic ở loader đang là:

• Nếu chỉ chọn Đã hoàn thành thì query dùng userStatus = COMPLETED
• Nếu chỉ chọn Chưa hoàn thành thì query dùng userStatus = ON_GOING
• Nếu bỏ trống cả hai hoặc chọn cả hai, loader sẽ không ép một trạng thái cụ thể

Vì vậy, nếu bạn vô tình bật cả hai ô, kết quả thực tế gần như quay về trạng thái xem toàn bộ truyện theo sort hiện tại.

5. Cột thể loại bên phải hoạt động như thế nào?

Ở desktop, bên dưới card tình trạng sẽ có danh sách các thể loại A-Z. Đây không phải là bộ lọc đa chọn nằm ngay trong trang Danh sách. Mỗi thể loại thực chất là một link điều hướng sang route thể loại riêng, ví dụ /genres/....

Điều này có nghĩa là:

• Bấm vào thể loại sẽ mở trang genre tương ứng
• Nó không cộng dồn nhiều genre ngay trong route /danh-sach
• Trên mobile phần này bị ẩn để giao diện gọn hơn

Nếu bạn muốn chọn nhiều thể loại cùng lúc, route phù hợp hơn là tìm kiếm nâng cao.

6. Cách dùng phân trang: Đầu, Cuối, nhập số và Đi

Đây là phần hữu ích nhất nếu bạn đang ở các trang rất xa và không muốn bấm tay từng trang một. Component phân trang hiện tại có 4 nhóm thao tác:

1. Nút Đầu

Nút Đầu sẽ đưa bạn thẳng về trang 1. Nếu bạn đang đứng ở trang 1, nút này sẽ bị mờ và không bấm được.

2. Dải số trang quanh vị trí hiện tại

Component không hiển thị toàn bộ số trang cùng lúc. Nó chỉ hiện dải quanh trang hiện tại theo logic current ± 2. Nếu còn nhiều trang ở đầu hoặc cuối, giao diện sẽ chèn dấu ....

Ví dụ: nếu bạn đang ở trang 50, khu vực số sẽ thiên về 48, 49, 50, 51, 52 và có ... ở hai đầu nếu tổng số trang còn dài.

3. Nút Cuối

Nút Cuối đưa bạn thẳng tới trang cuối cùng. Đây là cách nhanh nhất để kiểm tra đuôi danh sách mà không phải nhảy từng cụm.

4. Ô nhập số trang + nút Đi

Đây là tính năng bạn hỏi tới và cũng là cách tối ưu nhất để đi tới trang xa. Cách dùng đúng là:

1. Nhìn tổng số trang hiện có
2. Nhập trực tiếp số trang mong muốn vào ô Trang
3. Bấm Đi

Code đang sanitize ô này khá chặt: chỉ giữ ký tự số, và nút Đi chỉ sáng khi số bạn nhập nằm trong khoảng từ 1 đến tổng số trang. Nếu nhập số âm, quá lớn hoặc không hợp lệ, nút sẽ bị disable và không cho submit.

7. Khi nào hệ thống tự đưa bạn về trang 1?

Đây là một hành vi rất hợp lý của route /danh-sach nhưng nhiều người không để ý. Có 2 tình huống sẽ tự reset về trang 1:

• Khi bạn đổi sort
• Khi bạn bấm Lọc lại theo tình trạng

Lý do là khi đổi điều kiện, trang cũ có thể không còn hợp lệ hoặc không còn ý nghĩa. Ví dụ bạn đang ở trang 120 của sort “Xem nhiều”, sau đó đổi qua “Mới nhất”, việc ở lại trang 120 thường không hữu ích bằng quay về trang 1 của tập kết quả mới.

8. Mẹo dùng nhanh để duyệt kho truyện hiệu quả

• Dùng Mới cập nhật khi bạn quay lại site mỗi ngày để theo chương mới.
• Dùng Mới nhất khi bạn muốn kiểm tra các bộ vừa được thêm lên hệ thống.
• Dùng Xem nhiều khi muốn tìm các bộ phổ biến mà không cần biết tên.
• Dùng A-Z / Z-A khi bạn nhớ sơ chữ cái đầu của truyện và muốn rà tên theo alphabet.
• Nếu cần share lại trạng thái đang xem, bạn có thể copy luôn URL chứa sort, status và page. Route này lưu mọi thao tác chính vào query string.
• Nếu bạn muốn từ một list rộng chuyển sang lọc sâu theo nhiều genre, hãy chuyển qua bài hướng dẫn tìm kiếm nâng cao.

9. FAQ - Câu hỏi thường gặp

10. Kết luận

Trang Danh sách truyện là công cụ mạnh để duyệt kho truyện trên Vinahentai theo kiểu rộng: đổi sort, lọc tình trạng và nhảy nhanh giữa các trang rất xa. Chỉ cần nhớ đúng 3 điểm là bạn sẽ dùng cực kỳ mượt:

• Mới cập nhật khác Mới nhất
• Filter thật của route hiện chỉ là tình trạng
• Muốn sang trang xa, hãy dùng ô nhập số + Đi thay vì bấm thủ công