antd_floating library
antd_floating — Ant Design v6 Floating 独立组件包(overlay 悬浮类)
从主包 antd_flutter_plus 拆分的独立组件包:
- AntFloatingPanel — 可拖拽的底部浮动面板,锚点间平滑移动并动画吸附
- AntFloatingPanelController — 面板程序化控制(吸附到锚点/展开/收起/重置)
- AntFloatingBubble — 可拖拽悬浮气泡,支持菜单展开与边缘磁吸
- AntFloatingBubbleController — 气泡程序化控制(显示/隐藏/吸附边缘/重置位置)
依赖方向约定:antd_floating → antd_theme(+ material_ui), 不依赖主包 antd_flutter_plus;主包通过 export re-export 保持零符号破坏。
R33 判定:浮动面板/气泡为 overlay 悬浮类组件(Stack/Overlay 内悬浮定位), 不参与 CustomScrollView 滚动组合,不需要 sliver 变体。
import 'package:antd_floating/antd_floating.dart';
AntFloatingPanel(
anchors: [0.3, 0.6, 1],
child: ListView(children: [Text('内容')]),
);
AntFloatingBubble(
initialPos: Offset(300, 500),
child: Icon(AntIcons.editOutlined),
);
Classes
- AntFloatingBubble
- Ant Design 悬浮气泡。
- AntFloatingBubbleController
- 悬浮气泡控制器 — 程序化控制气泡显示/隐藏/位置/边缘吸附(R35 判定落地)。
- AntFloatingBubbleControllerDelegate
- 悬浮气泡控制器内部委托(由 AntFloatingBubble State 实现)。
- AntFloatingBubbleMenuAction
- 悬浮气泡菜单项(点击按钮展开的动作条目)。
- AntFloatingPanel
- 浮动面板 — 可拖拽的底部浮动面板,在锚点间平滑移动并动画吸附。
- AntFloatingPanelController
- 浮动面板控制器 — 程序化控制面板高度/吸附/展开收起(R35 判定落地)。
- AntFloatingPanelControllerDelegate
- 浮动面板控制器内部委托(由 AntFloatingPanel State 实现)。
Enums
- AntFloatingBubbleAxis
- 悬浮气泡可拖拽轴向。
- AntFloatingBubbleEdge
- 悬浮气泡可吸附的父容器边缘。
Constants
- kAntFloatingPanelContentKey → const Key
- kAntFloatingPanelHandleKey → const Key
- kAntFloatingPanelKey → const Key
- 组件内部 Key,便于测试定位。
Typedefs
- AntFloatingPanelHeightChange = void Function(double heightPercent)
- 浮动面板高度变化回调签名。