Skip to main content
Đây là tài liệu Inertia.js v1, phiên bản không còn được duy trì tích cực. Vui lòng tham khảo tài liệu v3.

Đặt lại vị trí cuộn

Khi điều hướng giữa các trang, Inertia mô phỏng hành vi mặc định của trình duyệt bằng cách tự động đưa vị trí cuộn của document body (cũng như mọi vùng cuộn bạn đã định nghĩa) trở lại đầu trang. Ngoài ra, Inertia theo dõi vị trí cuộn của từng trang và tự động khôi phục vị trí đó khi bạn điều hướng tiến hoặc lùi trong lịch sử trình duyệt.

Giữ vị trí cuộn

Đôi khi bạn muốn ngăn hành vi đặt lại vị trí cuộn mặc định khi thực hiện visit. Bạn có thể tắt hành vi này bằng cách đặt tùy chọn preserveScroll thành false.
Nếu chỉ muốn giữ vị trí cuộn khi response có lỗi validation, hãy đặt tùy chọn preserveScroll thành “errors”.
Bạn cũng có thể đánh giá trì hoãn tùy chọn preserveScroll dựa trên response bằng cách cung cấp một callback.
Khi sử dụng liên kết Inertia, bạn có thể giữ vị trí cuộn bằng prop preserveScroll.

Vùng cuộn

Nếu ứng dụng không cuộn bằng document body mà dùng các phần tử có thể cuộn (thông qua thuộc tính CSS overflow), cơ chế đặt lại vị trí cuộn sẽ không hoạt động. Trong những trường hợp này, bạn phải cho Inertia biết phần tử cuộn nào cần được quản lý bằng cách thêm thuộc tính scroll-region vào phần tử đó.

Tài liệu chính thức

Bài dịch này được đối chiếu từ tài liệu Inertia.js v1 chính thức. Nếu có khác biệt do phiên bản hoặc cập nhật mới, hãy ưu tiên tài liệu chính thức làm nguồn tham chiếu.