Flutter 可拖动面板:用手势调整高度

通过拖动增量调整面板高度,处理折叠状态、上下边界与窗口尺寸变化。

适用版本

原项目发布于 2021 年;示例改用逻辑像素与拖动增量表达。

本文目录
  1. 在逻辑像素中调整高度
  2. 约束交由外层布局确定
  3. 参考与源码

原项目通过拖动面板标题调整内容区高度,并提供折叠按钮。实现时要区分内容是否展开、当前高度和可用高度边界。

在逻辑像素中调整高度

Flutter 布局使用逻辑像素。原实现混用了 window.physicalSize 和 MediaQuery,并通过固定偏移补偿按下时的跳动。用 DragUpdateDetails.delta.dy 累加每次拖动增量,可以直接描述这类交互。

dart
class ResizablePanel extends StatefulWidget {
  const ResizablePanel({super.key});

  @override
  State<ResizablePanel> createState() => _ResizablePanelState();
}

class _ResizablePanelState extends State<ResizablePanel> {
  double _height = 180;
  bool _expanded = true;

  @override
  Widget build(BuildContext context) {
    return LayoutBuilder(builder: (context, constraints) {
      final limit = constraints.hasBoundedHeight
          ? constraints.maxHeight
          : MediaQuery.sizeOf(context).height;
      final headerHeight = limit.clamp(0.0, 48.0).toDouble();
      final maxHeight = (limit - headerHeight).clamp(0.0, 480.0).toDouble();
      final minHeight = maxHeight < 120 ? maxHeight : 120.0;
      final visibleHeight = _height.clamp(minHeight, maxHeight).toDouble();
      return Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          GestureDetector(
            behavior: HitTestBehavior.opaque,
            onVerticalDragUpdate: _expanded ? (details) {
              setState(() {
                _height = (_height.clamp(minHeight, maxHeight).toDouble()
                    - details.delta.dy)
                    .clamp(minHeight, maxHeight).toDouble();
              });
            } : null,
            child: SizedBox(
              height: headerHeight,
              child: Row(children: [
              const Expanded(child: Text('拖动调整高度')), 
              IconButton(
                tooltip: _expanded ? '收起' : '展开',
                onPressed: () => setState(() => _expanded = !_expanded),
                icon: Icon(_expanded ? Icons.expand_more : Icons.expand_less),
              ),
              ]),
            ),
          ),
          if (_expanded)
            SizedBox(height: visibleHeight, child: const Placeholder()),
        ],
      );
    });
  }
}

使用这段组件时导入 package:flutter/material.dart。这是底部面板“向上拖动增高”的方向:delta.dy 为负时高度增加。顶部面板若要向下拖动增高,把减法改成加法。

约束交由外层布局确定

示例先为标题预留最多 48 个逻辑像素,再计算内容高度。父级提供有限高度时,标题与内容一起受该范围限制;横竖屏切换、桌面缩窗时,按新的可用空间重新限制高度。

收起时保留上次高度,展开后恢复;拖动回调在收起状态下关闭。若内容自身可滚动,把拖动手柄限制在标题区,避免内容滚动与调整高度争抢手势。

参考与源码

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。