在shadcn-ui项目中优雅实现数据表格行操作的Toast反馈

问题背景

在使用shadcn-ui构建数据表格时，开发者经常需要在行操作(如删除)后提供用户反馈。常见的做法是使用Toast通知来告知用户操作结果。然而，直接在表格列的cell函数中调用React Hook(如useToast)会导致ESLint报错，因为cell函数本身不符合React组件或自定义Hook的命名规范。

错误示例分析

最初尝试直接在columns.tsx文件中定义cell函数并调用useToast：

cell: ({ row }) => {
  const { toast } = useToast(); // 这里会触发ESLint错误
  // ...其他逻辑
}

这种写法虽然能在开发环境中工作，但在生产构建时会触发ESLint规则错误，因为：

1. cell函数不是React组件(名称未大写)
2. 也不是自定义Hook(名称未以"use"开头)
3. 违反了React Hook的调用规则

最佳实践解决方案

1. 创建独立的CellAction组件

更优雅的解决方案是将行操作逻辑提取到单独的React组件中：

const CellAction = ({ row }: CellContext<File, unknown>) => {
  const { toast } = useToast(); // 现在可以安全地使用Hook
  const router = useRouter();
  
  const handleDelete = async () => {
    const { success } = await deleteFileById(row.original.key);
    
    if (!success) {
      toast({
        variant: "default",
        description: "删除文件失败"
      });
      return;
    }
    
    toast({
      variant: "success",
      description: "文件删除成功"
    });
    router.refresh();
  };

  return (
    <DropdownMenu>
      {/* 下拉菜单实现 */}
    </DropdownMenu>
  )
}

2. 在列定义中使用组件

然后在列定义中直接引用这个组件：

export const columns: ColumnDef<File>[] = [
  {
    id: "actions",
    cell: CellAction // 直接引用组件
  }
]

技术要点解析

1. 组件化思维：将UI和逻辑封装成独立组件，符合React的设计哲学
2. Hook使用规范：确保Hook只在React组件或自定义Hook中调用
3. 关注点分离：将Toast反馈逻辑与表格列定义分离，提高代码可维护性
4. 用户体验优化：提供清晰的操作反馈，包括成功和失败状态

扩展建议

1. 加载状态处理：可以在删除操作时添加加载状态，防止用户重复点击
2. 确认对话框：重要操作前添加确认步骤，避免误操作
3. 错误详情展示：失败时可以展示更详细的错误信息
4. 国际化支持：将提示文本提取为国际化资源

这种组件化的实现方式不仅解决了ESLint报错问题，还使代码结构更加清晰，便于后续维护和扩展。