在shadcn-ui/ui项目中自定义Sonner Toast按钮布局的实践

背景介绍

在shadcn-ui/ui项目中，Sonner Toast组件是一个非常实用的通知提示工具。Toast通知通常包含标题、描述内容和操作按钮，默认情况下操作按钮位于Toast的右侧。然而在实际开发中，当描述内容较长时，这种布局会导致界面拥挤，影响用户体验。

问题分析

默认的Toast布局将操作按钮放在右侧，这在描述文本较短时表现良好。但当描述文本超过40个字符时，会导致Toast宽度增加，使得整体布局不够美观，用户阅读体验下降。开发者需要一种方法能够将操作按钮移动到Toast底部，以优化长文本情况下的显示效果。

解决方案

1. 使用flex布局调整按钮位置

通过为Toast添加flex-col类名，可以改变其内部元素的排列方向，使操作按钮移动到Toast底部：

toast("标题", {
  className: "flex-col",
  description: "较长的描述文本...",
  action: {
    label: "操作",
    onClick: () => console.log("操作执行")
  }
});

这种方法简单有效，但需要注意当Toast包含图标时，图标的位置可能会受到影响。

2. 处理图标位置问题

当使用toast.info等带图标的Toast时，简单的flex-col会导致图标居中显示。此时可以使用grid布局或添加额外的对齐类：

toast.info("标题", {
  classNames: {
    toast: "flex-col items-start",
    // 其他样式...
  },
  // 其他配置...
});

3. 自定义按钮样式

为了进一步优化按钮显示效果，可以自定义按钮的宽度和样式：

toast.info("标题", {
  classNames: {
    toast: "flex-col items-start",
    actionButton: "w-full justify-center",
  },
  // 其他配置...
});

4. 高级样式定制

当需要深度定制按钮样式时，可以使用!important标记覆盖默认样式：

toast.info("标题", {
  classNames: {
    actionButton: "group-[.toast]:!bg-red-500 group-[.toast]:!text-white",
  },
  // 其他配置...
});

完整示例

以下是一个完整的Toast配置示例，包含了标题、长描述、底部全宽按钮以及自定义样式：

toast.info("生日贺卡", {
  description: "我们想为您发送一张生日贺卡，您同意吗？",
  closeButton: true,
  duration: Infinity,
  action: {
    label: "接受",
    onClick: () => handleAccept()
  },
  classNames: {
    toast: "flex-col items-start gap-4",
    actionButton: "!h-8 w-full !justify-center !rounded-md !bg-primary"
  }
});

注意事项

1. 当使用自定义JSX渲染Toast时，需要手动处理关闭逻辑
2. 深度定制样式时要注意样式优先级问题
3. 考虑不同Toast类型(info/success/error等)的默认样式差异
4. 在移动端需要测试响应式表现

总结

通过灵活运用Sonner Toast的classNames配置，开发者可以轻松实现按钮位置的调整和样式的自定义。这种技术特别适合需要展示较长描述文本的场景，能够显著提升用户界面的可读性和美观度。在实际项目中，建议根据具体需求选择合适的定制方案，并在不同设备和场景下进行充分测试。