Skip to content

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,同步 variantroundedshadowbouncesplashsxcomponent 以及原生按钮属性。
  • 新增 GhostButtonGroup 组件,支持用一个主悬浮按钮唤起一组快捷操作按钮。
  • GhostButtonGroup 支持 trigger="click" | "hover" 和触发数组组合,支持 direction 控制展开方向、gap 控制展开间距。
  • GhostButtonGroup 同时支持 items 数据式配置和 GhostButtonGroup.Item 组合式声明。

优化

  • GhostButton 的定位 API 调整为直接支持 position,同时移除单独的 display
  • GhostButton 的默认定位方式从写死 className 收口到 style 层,使 position="absolute" | "static" | "sticky" 等覆盖更直观。
  • GhostButtonGhostButtonGroup 默认 zIndex 提升为 10,更符合悬浮操作组件的默认层级预期。
  • GhostButtonGroup 展开项补充逐个浮现与逐个消失的过渡编排效果,增强展开反馈。

修复

  • 修复 GhostButton 在文档示例与局部容器场景下仍然受到写死 fixed 类名影响的行为。
  • 修复 GhostButtonGroup 在触发按钮使用非 fixed / absolute 定位时,展开项没有正确跟随触发按钮的问题。
  • 修复 GhostButtonGrouptrigger="click" 首次展开时入场动画不生效的问题。
  • 修复 GhostButtonGroup 在 compose 写法下,GhostButtonGroup.Item 未被稳定识别导致点击主按钮无法展开的问题。

文档

  • 新增 GhostButton 文档页,包含基础用法、尺寸、定位、Button API 对齐、局部容器使用示例。
  • GhostButton 补充 3 个 React demo:基础用法、尺寸展示与定位示例。
  • 新增 GhostButtonGroup 文档页,包含基础展开、触发方式、展开方向、间距和 compose 写法示例。
  • GhostButtonGroup 补充 3 个 React demo:基础 items 用法、不同 trigger / direction 组合、GhostButtonGroup.Item 组合式写法。
  • 组件侧边栏新增 GhostButtonGhostButtonGroup 入口,并同步文档页中的 API 表格与示例代码。

验证

  • npm run typecheck 通过。
  • npm run build:types 通过。
  • npm run build:docs 通过。