v0.5.0
- 发布日期: 2026-04-28
- 版本:
0.5.0
新增
- 新增
GhostButton组件,默认position="fixed"、right={16}、bottom={16},默认在右下角悬浮显示为圆形按钮。 GhostButton支持 5 档预设尺寸xs | sm | md | lg | xl,同时支持number和任意 CSS 尺寸字符串。GhostButton底层复用Button,同步variant、rounded、shadow、bounce、splash、sx、component以及原生按钮属性。- 新增
GhostButtonGroup组件,支持用一个主悬浮按钮唤起一组快捷操作按钮。 GhostButtonGroup支持trigger="click" | "hover"和触发数组组合,支持direction控制展开方向、gap控制展开间距。GhostButtonGroup同时支持items数据式配置和GhostButtonGroup.Item组合式声明。
优化
GhostButton的定位 API 调整为直接支持position,同时移除单独的display。GhostButton的默认定位方式从写死className收口到style层,使position="absolute" | "static" | "sticky"等覆盖更直观。GhostButton与GhostButtonGroup默认zIndex提升为10,更符合悬浮操作组件的默认层级预期。GhostButtonGroup展开项补充逐个浮现与逐个消失的过渡编排效果,增强展开反馈。
修复
- 修复
GhostButton在文档示例与局部容器场景下仍然受到写死fixed类名影响的行为。 - 修复
GhostButtonGroup在触发按钮使用非fixed/absolute定位时,展开项没有正确跟随触发按钮的问题。 - 修复
GhostButtonGroup在trigger="click"首次展开时入场动画不生效的问题。 - 修复
GhostButtonGroup在 compose 写法下,GhostButtonGroup.Item未被稳定识别导致点击主按钮无法展开的问题。
文档
- 新增
GhostButton文档页,包含基础用法、尺寸、定位、Button API 对齐、局部容器使用示例。 - 为
GhostButton补充 3 个 React demo:基础用法、尺寸展示与定位示例。 - 新增
GhostButtonGroup文档页,包含基础展开、触发方式、展开方向、间距和 compose 写法示例。 - 为
GhostButtonGroup补充 3 个 React demo:基础items用法、不同trigger/direction组合、GhostButtonGroup.Item组合式写法。 - 组件侧边栏新增
GhostButton与GhostButtonGroup入口,并同步文档页中的 API 表格与示例代码。
验证
npm run typecheck通过。npm run build:types通过。npm run build:docs通过。