HeroUI v2.8.0

HeroUI 版本 v2.8.0 引入 TailwindCSS v4，改进和错误修复。

What's New in v2.8.0?

• TailwindCSS v4 - 支持 TailwindCSS 并升级各类依赖。
• Overlay Enhancement - 提升弹窗、模态、下拉、选择及工具提示的遮罩层和外部交互一致性。
• Component Enhancement - 增强组件功能。
• What's Next? - 即将推出的功能与改进。
• Breaking Changes - 重要变更，可能影响现有实现。
• Release Changes - 详细功能、文档更新、错误修复与改进列表。

今天即可升级，使用以下任一方法：

1. 使用 cli 升级 HeroUI

2. 使用包管理器升级 HeroUI

TailwindCSS v4

HeroUI 现已兼容 TailwindCSS v4。配合升级后的 CLI，可以初始化预配置 TailwindCSS v4 的起始模板。

如需升级现有项目，请参阅 迁移指南。

Overlay Enhancement

Popover、Modal、Dropdown、Select 与 Tooltip 等组件的遮罩层与外部交互处理已得到改进，以实现一致的关闭行为。

Component Enhancement

Toast

• addToast 的返回类型已从 void 更改为 string，返回的新字符串为新创建 Toast 的唯一键值。
• 新增 closeToast(key: string): void 方法，接受字符串类型的键值，提供通过唯一键程序化关闭特定 Toast 的方式。
• Toast 关闭顺序已从 LIFO（后进先出）更新为 FIFO（先进先出）。

Input

Input 组件新增 outside-top 的标签位置选项。此前，如果没有占位符，标签始终留在输入框内。

新的 outside-top 选项确保标签始终显示在输入框顶部，是否存在占位符与之前的 outside-left 一致。

Select

• Select 组件新增 isClearable 与 onClear 两个属性。当选择值后，显示清除按钮，并在清除时触发自定义回调。

• Select 组件新增 endContent。

Table

表头原先使用 chevron-up 或 chevron-down 图标进行排序，无法配置。现新增 sortIcon 属性，允许用户自定义默认排序图标。此图标仅在 allowsSorting 为 true 时生效。

Slider

新增 getTooltipValue 属性，可通过返回字符串或数字来自定义工具提示内容。若返回数字，可配合现有 tooltipValueFormatOptions 进一步格式化。若已设置 tooltipProps.content，其优先级高于 getTooltipValue 生成的值。

What's Next?

我们很高兴地宣布 HeroUI v3（Alpha）即将上线！你将能用 50% 更小的包体积、极速原生 CSS 动画以及轻松的自定义，打造出惊艳的界面。

作为 Alpha 版本，我们正积极收集反馈并完善当前组件，包括 Button、Accordion、Avatar、TextArea、Checkbox 等。你的意见对库的未来至关重要。

Breaking Changes

• 组件样式已更新以匹配 TailwindCSS v4。
• loadingIcon 在 Toast 组件中改名为 loadingComponent。

Release Changes

一如既往，感谢你持续的支持与贡献。未来还有许多激动人心的里程碑，邀请你加入我们的旅程。

特别感谢 HeroUI 团队成员 @winchesHe、@macci001、@Vishvsalvi 及贡献者对本次发布的贡献。

感谢阅读，祝编码愉快！ 🚀

Community

我们很高兴看到社区在采用 HeroUI、提出问题并提供反馈。
不管是功能请求、错误报告还是想要展示的项目，请积极参与！

Contributing

HeroUI 的 PR 始终受欢迎，请查看我们的贡献指南以了解如何为此项目做出贡献。