React Table7开发表格触发缺少唯一key prop警告的问题排查
遗漏的key配置位置
你已在headerGroup遍历、普通表格行<tr>上配置的key,并不是触发警告的原因,真正漏配的位置共有3处:
- 表头列遍历的
<th>元素
对应代码为headerGroup.headers.map((column) => <th ... />)。React Table 7的column.getHeaderProps()默认不会自动注入key属性,这层map的直接返回项就是<th>,你没有给这个元素设置独立key。 - 行遍历的根元素
<React.Fragment>
对应代码为page.map遍历的返回节点。这层map的直接返回项是外层的<React.Fragment>,你把key={row.id}加在了Fragment内部的普通行<tr>上。列表项的key必须绑定在map返回的最外层根节点上,加在内部子节点上无法被React的diff逻辑识别。且普通写法的<React.Fragment>不支持接收key属性,需要替换为可绑定key的Fragment组件写法。 - 单元格遍历的
<td>元素
对应代码为row.cells.map((cell) => <td ... />)。React Table 7的cell.getCellProps()同样不会自动注入key属性,这层map的直接返回项就是<td>,你没有给这个元素设置独立key。
修复参考
// 从react中导入可绑定key的Fragment组件 import { Fragment } from 'react'; // thead 部分修改 <thead> {headerGroups.map((headerGroup) => ( <tr {...headerGroup.getHeaderGroupProps()} key={headerGroup.id}> {headerGroup.headers.map((column) => ( <th key={column.id} className={`p-2 table-header ${headerColor ? "primary-" + headerColor : "primary-deq"}`} {...column.getHeaderProps()} > {/* 原有内部逻辑保持不变 */} </th> ))} </tr> ))} </thead> // tbody 部分修改 <tbody {...getTableBodyProps()}> {page.map((row) => { prepareRow(row); return ( <Fragment key={row.id}> <tr {...row.getRowProps()} onClick={rowOnClick ? () => rowClickHandler(row.original) : () => ""} > {row.cells.map((cell) => ( <td key={cell.id} {...cell.getCellProps()}> {cell.render("Cell")} </td> ))} </tr> {row.isExpanded ? ( <tr> <td> <span className="subTable">{renderRowSubComponent({ row })}</span> </td> </tr> ) : null} </Fragment> ); })} </tbody>
注意:key移到Fragment上后,原本加在内部普通
<tr>上的key可以移除,避免冗余配置。
内容的提问来源于stack exchange,提问作者reactFullStackDeveloper。
相关产品推荐
相关产品推荐

