Chuyển tới nội dung

BKACAD

Trang chủ / Kiến thức CNTT / Devops / Đưa bộ lọc React lên URL để chia sẻ đúng kết quả tìm kiếm

Đưa bộ lọc React lên URL để chia sẻ đúng kết quả tìm kiếm

1. Tại sao nên đưa bộ lọc React lên URL search params?

Trong quá trình phát triển ứng dụng ReactJS, đặc biệt là các website thương mại điện tử, trang quản lý sản phẩm hay hệ thống tìm kiếm dữ liệu, bộ lọc là một thành phần gần như không thể thiếu. Người dùng thường xuyên cần lọc kết quả theo danh mục, mức giá, thương hiệu, trạng thái hoặc sắp xếp dữ liệu theo những tiêu chí khác nhau. Tuy nhiên, một vấn đề thường gặp là trạng thái bộ lọc chỉ được lưu trong component thông qua useState. Khi người dùng tải lại trang, chuyển sang một đường dẫn khác hoặc muốn gửi kết quả tìm kiếm cho người khác, toàn bộ lựa chọn trước đó có thể biến mất. Đây chính là lý do React bộ lọc URL search params trở thành một kỹ thuật quan trọng trong quá trình xây dựng giao diện người dùng.

Thay vì chỉ lưu trạng thái bộ lọc trong bộ nhớ của ứng dụng, lập trình viên có thể đưa những thông tin quan trọng lên URL thông qua query parameters. Ví dụ, khi người dùng lựa chọn danh mục công nghệ, mức giá từ 1 đến 5 triệu đồng và sắp xếp theo giá tăng dần, URL có thể được biểu diễn như sau:

/products?category=technology&minPrice=1000000&maxPrice=5000000&sort=price-asc

Khi đó, đường dẫn không chỉ xác định trang đang truy cập mà còn thể hiện chính xác các điều kiện tìm kiếm. Bất kỳ ai truy cập URL này đều có thể nhận được cùng một trạng thái bộ lọc, miễn là ứng dụng xử lý các tham số tương ứng.

Việc sử dụng React bộ lọc URL search params mang lại ba lợi ích nổi bật:

  • Duy trì trạng thái tìm kiếm: Khi tải lại trang hoặc quay lại đường dẫn trước đó, ứng dụng có thể khôi phục những bộ lọc đã lựa chọn thay vì đưa người dùng về trạng thái mặc định.
  • Chia sẻ kết quả dễ dàng: Người dùng chỉ cần sao chép URL và gửi cho người khác để chia sẻ danh sách dữ liệu đã được lọc theo đúng tiêu chí.
  • Cải thiện trải nghiệm điều hướng: URL phản ánh trạng thái hiện tại của giao diện, giúp việc sử dụng nút Back và Forward trên trình duyệt trở nên hữu ích hơn.
    url search params state management diagram

Bên cạnh trải nghiệm người dùng, việc tổ chức URL bằng query parameters cũng cần được thực hiện hợp lý. Theo Google Search Central, URL nên có cấu trúc dễ hiểu, sử dụng các cặp key-value phổ biến và hạn chế những tham số không cần thiết. Điều này đặc biệt quan trọng với các website có nhiều bộ lọc kết hợp, bởi quá nhiều biến thể URL có thể tạo ra những trang nội dung gần giống nhau.

2. Cách triển khai React bộ lọc URL search params với React Router

Để triển khai kỹ thuật này, lập trình viên có thể sử dụng API URLSearchParams có sẵn trong JavaScript hoặc hook useSearchParams của React Router. Trong những ứng dụng React sử dụng React Router, useSearchParams là lựa chọn thuận tiện vì cung cấp khả năng đọc và cập nhật query parameters trực tiếp trong component.

2.1. Sử dụng useSearchParams để đọc trạng thái bộ lọc từ URL

Trước tiên, cần cài đặt và cấu hình React Router nếu dự án chưa sử dụng thư viện này. Sau đó, import hook useSearchParams vào component chứa danh sách dữ liệu:

import { useSearchParams } from "react-router-dom";

function ProductList() {
  const [searchParams, setSearchParams] = useSearchParams();

  const category = searchParams.get("category") || "";
  const sort = searchParams.get("sort") || "default";
  const minPrice = searchParams.get("minPrice") || "";

  return (
    <div>
      <h2>Danh sách sản phẩm</h2>

      <p>Danh mục: {category || "Tất cả"}</p>
      <p>Sắp xếp: {sort}</p>
      <p>Giá tối thiểu: {minPrice || "Không giới hạn"}</p>
    </div>
  );
}

export default ProductList;

Trong ví dụ trên, useSearchParams trả về một mảng gồm hai giá trị. Giá trị đầu tiên là searchParams, cho phép truy xuất các tham số hiện có trong URL. Giá trị thứ hai là setSearchParams, được sử dụng để cập nhật các tham số khi người dùng thay đổi bộ lọc.

Một số phương thức thường được sử dụng với URLSearchParams gồm:

  • get("key"): Lấy giá trị của một tham số theo tên.
  • set("key", "value"): Thêm hoặc cập nhật giá trị của tham số.
  • delete("key"): Xóa một tham số khỏi URL.
  • has("key"): Kiểm tra sự tồn tại của tham số.
  • getAll("key"): Lấy tất cả giá trị của một tham số, hữu ích khi người dùng chọn nhiều danh mục hoặc thương hiệu.

Nhờ đó, lập trình viên có thể xây dựng cơ chế quản lý trạng thái bộ lọc React dựa trên chính URL thay vì phải khởi tạo lại toàn bộ dữ liệu bằng useState.

2.2. Cập nhật URL khi người dùng thay đổi bộ lọc

Sau khi đọc được dữ liệu từ URL, bước tiếp theo là cập nhật query parameters mỗi khi người dùng thay đổi lựa chọn. Ví dụ, khi người dùng chọn một danh mục sản phẩm mới, ứng dụng cần cập nhật URL tương ứng mà không làm mất những bộ lọc khác đang được áp dụng.

import { useSearchParams } from "react-router-dom";

function ProductFilter() {
  const [searchParams, setSearchParams] = useSearchParams();

  const handleCategoryChange = (event) => {
    const params = new URLSearchParams(searchParams);

    if (event.target.value) {
      params.set("category", event.target.value);
    } else {
      params.delete("category");
    }

    setSearchParams(params);
  };

  return (
    <select
      value={searchParams.get("category") || ""}
      onChange={handleCategoryChange}
    >
      <option value="">Tất cả danh mục</option>
      <option value="technology">Công nghệ</option>
      <option value="fashion">Thời trang</option>
      <option value="books">Sách</option>
    </select>
  );
}

export default ProductFilter;

Điểm quan trọng trong đoạn code là tạo một bản sao mới bằng new URLSearchParams(searchParams) trước khi chỉnh sửa. Cách làm này giúp tránh thay đổi trực tiếp đối tượng searchParams đang được sử dụng. Sau đó, setSearchParams sẽ cập nhật URL theo lựa chọn mới của người dùng.

Ví dụ, nếu URL ban đầu là:

/products?sort=price-asc&minPrice=1000000

Khi người dùng chọn danh mục công nghệ, URL sẽ trở thành:

/products?sort=price-asc&minPrice=1000000&category=technology

Những tham số cũ vẫn được giữ nguyên, chỉ có tham số category được bổ sung. Đây là nguyên tắc quan trọng khi triển khai React bộ lọc URL search params, đặc biệt đối với các trang có nhiều điều kiện tìm kiếm hoạt động đồng thời.

2.3. Kết hợp URL search params với dữ liệu và xử lý các lỗi thường gặp

Trong ứng dụng thực tế, việc cập nhật URL mới chỉ là một phần của quá trình triển khai. Lập trình viên còn cần đảm bảo dữ liệu hiển thị luôn tương ứng với những điều kiện tìm kiếm hiện tại. Chẳng hạn, khi người dùng lựa chọn danh mục, khoảng giá và phương thức sắp xếp, danh sách sản phẩm cần được lọc dựa trên toàn bộ các tham số đó.

Một cách triển khai đơn giản là đọc các giá trị từ URL rồi sử dụng chúng để lọc dữ liệu:

const category = searchParams.get("category") || "";
const sort = searchParams.get("sort") || "default";

const filteredProducts = products
  .filter((product) =>
    category ? product.category === category : true
  )
  .sort((a, b) => {
    if (sort === "price-asc") {
      return a.price - b.price;
    }

    if (sort === "price-desc") {
      return b.price - a.price;
    }

    return 0;
  });

Với cách tiếp cận này, URL trở thành nguồn dữ liệu đầu vào cho trạng thái bộ lọc. Khi người dùng mở một đường dẫn đã được chia sẻ, ứng dụng có thể đọc các tham số và hiển thị danh sách tương ứng.

Tuy nhiên, khi triển khai React bộ lọc URL search params, có một số vấn đề cần chú ý:

  • Không kiểm tra giá trị đầu vào: Các tham số trên URL có thể bị chỉnh sửa thủ công. Vì vậy, cần kiểm tra kiểu dữ liệu, giới hạn giá trị và xử lý những tham số không hợp lệ trước khi sử dụng.
  • Xóa nhầm các bộ lọc khác: Nếu cập nhật URL bằng một object mới chỉ chứa một tham số, những điều kiện tìm kiếm trước đó có thể bị mất. Hãy sao chép các tham số hiện có trước khi thay đổi.
  • Đồng bộ không nhất quán giữa giao diện và URL: Giá trị mặc định của input, select hoặc checkbox nên được khởi tạo từ query parameters để tránh tình trạng URL thể hiện một lựa chọn nhưng giao diện lại hiển thị lựa chọn khác.
  • Lạm dụng query parameters: Không nên đưa mọi trạng thái giao diện lên URL. Chỉ những thông tin có ý nghĩa đối với việc tìm kiếm, lọc hoặc điều hướng mới nên được lưu lại.

Ngoài ra, với những bộ lọc có nhiều lựa chọn, lập trình viên có thể sử dụng getAll() và append() để quản lý các giá trị lặp lại. Nếu có nhiều thao tác cập nhật trong cùng một lượt xử lý, nên gom chúng vào một lần cập nhật setSearchParams để tránh ghi đè dữ liệu ngoài ý muốn. Đặc biệt, React Router không áp dụng cơ chế xếp hàng cập nhật giống setState đối với các lần gọi setSearchParams liên tiếp trong cùng một tick.

Kết luận: Đưa bộ lọc lên URL là một kỹ thuật cần thiết khi phát triển các ứng dụng ReactJS có chức năng tìm kiếm và lọc dữ liệu. Việc kết hợp React bộ lọc URL search params với useSearchParams giúp ứng dụng duy trì trạng thái, hỗ trợ chia sẻ kết quả tìm kiếm và cải thiện trải nghiệm điều hướng. Khi được triển khai đúng cách, kỹ thuật này không chỉ giúp code dễ quản lý hơn mà còn tạo nền tảng tốt cho việc mở rộng các tính năng tìm kiếm phức tạp trong tương lai.

Nếu bạn đang muốn xây dựng nền tảng vững chắc về ReactJS, từ cách quản lý state, xây dựng component đến xử lý routing và phát triển ứng dụng thực tế, việc tham gia một chương trình đào tạo có lộ trình bài bản sẽ giúp quá trình học tập hiệu quả hơn.

Khám phá khóa học Frontend ReactJS tại BKACAD: https://frontend-reactjs.bkacad.edu.vn/ để tìm hiểu chương trình đào tạo và phát triển kỹ năng xây dựng giao diện web hiện đại với ReactJS.

Chia sẻ bài viết

Bài viết liên quan

Chuẩn hóa lỗi validation trong REST API Spring Boot để frontend hiển thị đúng trường

Trong quá trình phát triển ứng dụng web, việc kiểm tra dữ liệu đầu vào (Validation) là một bước quan trọng nhằm đảm bảo tính chính xác và nhất quán...

Học Photoshop từ cơ bản đến nâng cao: Lộ trình cho người mới

Học Photoshop từ cơ bản đến nâng cao nên bắt đầu với giao diện, Layer, công cụ tạo vùng chọn và Layer Mask, sau đó chuyển sang chỉnh màu, retouch...

Thiết kế ấn phẩm truyền thông là gì? Kỹ năng cần có

Thiết kế ấn phẩm truyền thông là quá trình sử dụng hình ảnh, màu sắc, typography và bố cục để tạo ra các sản phẩm phục vụ hoạt động quảng bá, giới...

Học Canva có đủ để làm thiết kế đồ họa chuyên nghiệp?

Học Canva có thể đủ để thực hiện nhiều công việc thiết kế đồ họa chuyên nghiệp ở mức cơ bản đến trung cấp, đặc biệt trong Social Media, Content...

Tư duy thiết kế là gì? 7 nguyên tắc thiết kế chuyên nghiệp

Tư duy thiết kế là khả năng phân tích vấn đề, tổ chức thông tin và lựa chọn các yếu tố thị giác để tạo ra sản phẩm vừa có tính thẩm mỹ, vừa truyền tải...

Người trái ngành có thể trở thành Graphic Designer không?

Người không học đúng chuyên ngành hoàn toàn có thể trở thành Graphic Designer nếu xây dựng được nền tảng tư duy thiết kế, sử dụng thành thạo các công...