Flutter BottomSheet 三段式拖拽

前面倒是有讲过Android原生的BottomSheetBehavior，使用场景还是蛮多的，最近在用Flutter做一款地图App，有用到BottomSheet的功能，但是 Flutter 自带的BottomSheet有点拉，只能显示和隐藏销毁，不支持折叠为最小高度状态也不支持三段式拖动，那就自己撸一个吧：

追踪 BottomSheet

既然是基于系统的BottomSheet ,不妨来看看sdk的实现方式，正常来讲，显示一个BottomSheet，可以通过showBottomSheet 来触发，或者给Scaffold配置bottomSheet属性，查看源码可以看到Scaffold.of(context).showBottomSheet，内部是创建了一个_StandardBottomSheet，继续追踪发现Widget其实是通过AnimatedBuilder来实现内容高度的扩展，其内部维护了一个BottomSheet。

简单阅读下BottomSheet源码，重点就在于 GestureDetector 的垂直方向上的手势回调 onVerticalDragUpdate 、以及onVerticalDragEnd，拖动位置更新、惯性滑动以及销毁，核心都在这了。

系统默认实现效果

• 拖拽速度大于某一个像素阀值时，销毁。
• 拖拽位置小于总高度的一半时，销毁。

保留这一份默认效果，对于想使用默认效果的同学，不做任何额外配置即可。

准备要实现的功能点：

1. 三段式: 基于SDK的BottomSheet ，可扩展为完全展开、中间状态、折叠状态；
2. 阻尼、惯性滑动: 支持配置最小滑动偏移量；
3. 保持状态，支持Peek状态: 以最小高度显示BottomSheet；
4. 打破 showBottomSheet 限制: 兼容系统默认的弹出方式，亦可当作正常的Widget使用，脱离showBottomSheet。

定义三段式状态：BottomSheetBehavoir

• EXPANDED 完全展开
• HALF 中间状态，介于EXPANDED与PEEK之间
• PEEK 以一个最小高度展示
• HIDDEN 完全隐藏，即销毁，系统默认效果

开启三段式，我们还需要配置一个约束条件，即BottomSheet的最大高度和最小高度 BoxConstraints:

• 最小高度
  HALF模式下
  如果提供的 Constraints minHeight 小于最大高度的一半，则取后者，防止位置错乱！

var peekThreshold = enableHalf
     ? min(_childHeight / 2, constraints.minHeight) / _childHeight
     : constraints.minHeight / _childHeight;

阀值定义

• 拖拽滚动阀值，大于此值，才允许滑动
  const double _offsetThreshold = 32.0;
• 展开时最大高度 阀值
  const double _maxThreshold = 1.0;
• 中间状态阀值
  const double _halfThreshold = 0.5;

当拖拽结束时，如果拖拽偏移量小于此阀值，则恢复状态，这里有个麻烦的点是需要根据用户拖拽方向来判断，是向上还是向下拖动。
方向判断可以在 _handleDragStart 回调时记录初始偏移量startY，_handleDragEnd 时计算开始和结束的差值

/// 偏移量
var offset = updateY-startY ;
/// 当前动画值
 var value = widget.animationController!.value;
 late double toValue;
 late BottomSheetBehavior mode;

offset<0 为向上滑动，反之 向下滑动。接下来需要根据滚动阀值来更新BottomSheet状态。

1. 未达到滚动阀值，恢复状态

• 向上滑动，恢复BottomSheet状态: Expanded / Half / Peek

if (value >= _maxThreshold) {
   // 处于Expand状态，恢复
   toValue = _maxThreshold;
   mode = BottomSheetBehavior.EXPANDED;
 } else if (value > _halfThreshold && enableHalf) {
   // 处于Half，恢复
   toValue = _halfThreshold;
   mode = BottomSheetBehavior.HALF;
 } else {
   toValue = peekThreshold;
   mode = BottomSheetBehavior.PEEK;
 }

• 向下滑动，恢复BottomSheet状态: Expanded / Half / Peek

if (value > _halfThreshold) {
   // 处于Expand状态，恢复
   toValue = _maxThreshold;
   mode = BottomSheetBehavior.EXPANDED;
 } else if (value > peekThreshold && enableHalf) {
   // 处于Half，恢复
   toValue = _halfThreshold;
   mode = BottomSheetBehavior.HALF;
 } else {
   toValue = peekThreshold;
   mode = BottomSheetBehavior.PEEK;
 }

2. 达到滚动阀值，更新状态

• 向上滑动，更新BottomSheet状态: Expanded / Half / Peek

if (value > _halfThreshold) {
   toValue = _maxThreshold;
   mode = BottomSheetBehavior.EXPANDED;
 } else if (value > peekThreshold) {
   toValue = enableHalf ? _halfThreshold : _maxThreshold;
   mode = enableHalf ? BottomSheetBehavior.HALF : BottomSheetBehavior.EXPANDED;
 } else {
   toValue = peekThreshold;
   mode = BottomSheetBehavior.PEEK;
 }

• 向下滑动，更新BottomSheet状态: Half / Peek

if (value > _halfThreshold) {
  toValue = enableHalf ? _halfThreshold : peekThreshold;
  mode = enableHalf ? BottomSheetBehavior.HALF : BottomSheetBehavior.PEEK;
} else {
  toValue = peekThreshold;
  mode = BottomSheetBehavior.PEEK;
}

以上，我们获取到了开始讲到的AnimatedBuilder的 动画值以及变化量，在**_handleDragEnd**中可以通过animateTo平滑的过渡BottomSheet状态

/// 以动画的形式fly
void animateTo(double to) {
  widget.animationController!.animateTo(
    to,
    curve: Curves.linearToEaseOut,
    duration: animateDuration,
  );
}

• 另外，至于BottomSheet的最新的状态回调，最好是在动画结束后再通知给调用者，以免更新状态期间build重绘！

Future.delayed(animateDuration, () => widget.onBehaviorChanged?.call(mode));

至此，既保留了flutter默认的BottomSheet效果，又扩展了三段式，当然，调用方式和系统BottomSheet一模一样，另外还可以像普通Widget一样来使用哦，来看看最终的效果吧

项目效果

Demo