Trong quá trình phát triển giao diện bằng ReactJS, việc hiển thị danh sách dữ liệu thông qua phương thức map() là một thao tác rất phổ biến. Tuy nhiên, bên cạnh việc tạo các phần tử trong danh sách, lập trình viên còn cần khai báo thuộc tính key để React có thể nhận diện và quản lý từng phần tử giữa các lần render. Một trong những lỗi thường gặp nhất là sử dụng index của mảng làm key. Cách làm này có thể hoạt động bình thường khi danh sách không thay đổi, nhưng lại gây ra nhiều vấn đề khi người dùng thực hiện sắp xếp, thêm hoặc xóa dữ liệu. Vậy tại sao React key index khi sắp xếp lại có thể khiến giao diện hiển thị sai dữ liệu? Nguyên nhân thực sự nằm ở cách React nhận diện component và duy trì state giữa các lần render.
Contents
1. Vì sao React key index khi sắp xếp có thể khiến dữ liệu hiển thị sai?
1.1. Vai trò của key trong React và cơ chế nhận diện phần tử
Trong React, khi render một danh sách phần tử bằng map(), mỗi phần tử cần có một thuộc tính key duy nhất trong cùng một nhóm phần tử cùng cấp. Thuộc tính này giúp React xác định phần tử nào tương ứng với dữ liệu nào giữa lần render trước và lần render tiếp theo.
Ví dụ, một danh sách người dùng có thể được hiển thị như sau:
const users = [
{ id: 1, name: "Minh" },
{ id: 2, name: "Lan" },
{ id: 3, name: "Nam" }
];
function UserList() {
return (
<ul>
{users.map((user) => (
<li key={user.id}>
{user.name}
</li>
))}
</ul>
);
}Trong ví dụ trên, user.id được sử dụng làm key vì mỗi người dùng có một mã định danh riêng. Khi danh sách thay đổi thứ tự, React vẫn có thể nhận diện chính xác từng người dùng dựa trên ID thay vì vị trí xuất hiện của họ trong mảng.
Đây chính là mục đích quan trọng của React key: giúp React theo dõi danh tính của từng phần tử, từ đó xác định phần tử nào được thêm mới, bị xóa, thay đổi hoặc di chuyển vị trí.
Ngược lại, nếu sử dụng index làm key, React sẽ dựa vào vị trí của phần tử trong mảng để nhận diện chúng. Điều này tạo ra vấn đề khi thứ tự danh sách thay đổi. Một phần tử đang có index bằng 0 có thể trở thành phần tử có index bằng 2 sau khi sắp xếp. Khi đó, key không còn đại diện chính xác cho danh tính ban đầu của dữ liệu.
1.2. Điều gì xảy ra khi sử dụng index làm key và sắp xếp danh sách?
Để hiểu rõ hơn lỗi React key index khi sắp xếp, hãy xem xét một danh sách gồm ba người dùng:
const users = [
{ id: 1, name: "Minh" },
{ id: 2, name: "Lan" },
{ id: 3, name: "Nam" }
];
function UserList() {
return (
<ul>
{users.map((user, index) => (
<li key={index}>
{user.name}
</li>
))}
</ul>
);
}Ban đầu, React nhận diện danh sách theo các cặp key và dữ liệu:
- Key 0: Minh.
- Key 1: Lan.
- Key 2: Nam.
Giả sử người dùng thực hiện sắp xếp danh sách theo thứ tự ngược lại. Dữ liệu lúc này trở thành Nam, Lan, Minh. Tuy nhiên, index của từng phần tử cũng thay đổi:
- Key 0: Nam.
- Key 1: Lan.
- Key 2: Minh.

Điểm đáng chú ý là React vẫn nhìn thấy các key 0, 1 và 2 giống với lần render trước. Vì vậy, React có thể tái sử dụng các component tương ứng với những key đó thay vì nhận diện đây là các dữ liệu đã di chuyển vị trí.
Nếu các phần tử chỉ chứa nội dung tĩnh, tên người dùng vẫn có thể được cập nhật đúng theo dữ liệu mới. Đây là lý do nhiều lập trình viên không nhận ra vấn đề khi chỉ kiểm tra giao diện cơ bản.
Tuy nhiên, khi mỗi phần tử chứa state riêng, chẳng hạn input không được kiểm soát (uncontrolled input), checkbox, trạng thái mở rộng hoặc dữ liệu nhập tạm thời, lỗi sẽ xuất hiện rõ ràng hơn. State vốn thuộc về component cũ có thể được giữ lại và gắn với dữ liệu mới đang sử dụng cùng key.
Ví dụ, người dùng nhập nội dung vào ô input của Minh. Sau khi đảo ngược danh sách, nội dung đó có thể xuất hiện ở dòng Nam vì component tại vị trí đầu tiên được React tái sử dụng.
Như vậy, lỗi không đơn thuần nằm ở việc sắp xếp mảng mà xuất phát từ sự không nhất quán giữa danh tính dữ liệu và key mà React sử dụng để nhận diện component.
2. Cách khắc phục lỗi React key index khi sắp xếp danh sách
2.1. Sử dụng ID ổn định thay vì index làm key
Giải pháp hiệu quả nhất để khắc phục lỗi React key index khi sắp xếp là sử dụng một thuộc tính định danh ổn định của dữ liệu, thường là id.
Ví dụ, thay vì viết:
{users.map((user, index) => (
<UserItem key={index} user={user} />
))}Hãy thay đổi thành:
{users.map((user) => (
<UserItem key={user.id} user={user} />
))}Với cách triển khai này, mỗi component luôn gắn với một ID cụ thể, bất kể vị trí của nó trong danh sách thay đổi như thế nào. Khi thực hiện sắp xếp, React có thể nhận diện đúng component dựa trên key ổn định và duy trì state tương ứng với từng dữ liệu.
Đối với những danh sách dữ liệu lấy từ API, lập trình viên nên ưu tiên sử dụng ID được cung cấp từ backend. Nếu dữ liệu chưa có ID, có thể tạo một mã định danh duy nhất ngay tại thời điểm khởi tạo hoặc thêm mới dữ liệu, sau đó lưu lại cùng đối tượng.
Cần lưu ý rằng không nên tạo key bằng Math.random() hoặc gọi hàm tạo UUID trực tiếp bên trong map() ở mỗi lần render. Việc này khiến key liên tục thay đổi, làm React hiểu rằng các phần tử cũ đã bị xóa và phần tử mới được tạo ra. Hậu quả là component có thể bị mount lại liên tục, mất state và gây ảnh hưởng đến hiệu suất.
2.2. Khi nào có thể sử dụng index làm key trong React?
Không phải mọi trường hợp sử dụng index làm key đều sai. Theo tài liệu chính thức của React, index có thể được sử dụng trong những danh sách tĩnh, khi các phần tử không bị thêm, xóa hoặc thay đổi thứ tự trong suốt vòng đời của danh sách.
Ví dụ, một danh sách các bước hướng dẫn cố định:
const steps = [
"Cài đặt Node.js",
"Khởi tạo dự án React",
"Chạy ứng dụng"
];
function Guide() {
return (
<ul>
{steps.map((step, index) => (
<li key={index}>{step}</li>
))}
</ul>
);
}Trong trường hợp này, thứ tự các phần tử không thay đổi và mỗi phần tử không chứa state riêng cần được duy trì. Do đó, sử dụng index làm key có thể chấp nhận được.
Tuy nhiên, với các danh sách động như danh sách sản phẩm, bảng quản lý người dùng, giỏ hàng, danh sách công việc hoặc kết quả tìm kiếm có chức năng lọc và sắp xếp, lập trình viên nên sử dụng ID ổn định.
Một nguyên tắc quan trọng cần ghi nhớ là: key phải duy nhất trong nhóm phần tử cùng cấp, ổn định giữa các lần render và gắn với danh tính thực sự của dữ liệu, không phải vị trí hiển thị của nó.
Kết luận
Việc sử dụng index làm key tưởng chừng đơn giản nhưng có thể tạo ra những lỗi khó phát hiện khi danh sách trong React thay đổi thứ tự. Đặc biệt, khi component chứa state riêng, input hoặc checkbox, React có thể tái sử dụng component không đúng với dữ liệu mà người dùng mong đợi. Hiểu rõ cơ chế React key index khi sắp xếp sẽ giúp lập trình viên tránh được những lỗi liên quan đến reconciliation, quản lý state và hiển thị giao diện.
Nếu bạn muốn xây dựng nền tảng vững chắc về ReactJS, từ cách tổ chức component, quản lý state đến xử lý danh sách và tối ưu hiệu suất giao diện, hãy tham khảo khóa học Frontend ReactJS tại BKACAD. Khóa học là định hướng phù hợp để bạn từng bước nâng cao kỹ năng phát triển giao diện web hiện đại và vận dụng ReactJS vào các dự án thực tế.

