适用版本
原项目发布于 2021 年;示例改用逻辑像素与拖动增量表达。
原项目通过拖动面板标题调整内容区高度,并提供折叠按钮。实现时要区分内容是否展开、当前高度和可用高度边界。
在逻辑像素中调整高度
Flutter 布局使用逻辑像素。原实现混用了 window.physicalSize 和 MediaQuery,并通过固定偏移补偿按下时的跳动。用 DragUpdateDetails.delta.dy 累加每次拖动增量,可以直接描述这类交互。
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 个逻辑像素,再计算内容高度。父级提供有限高度时,标题与内容一起受该范围限制;横竖屏切换、桌面缩窗时,按新的可用空间重新限制高度。
收起时保留上次高度,展开后恢复;拖动回调在收起状态下关闭。若内容自身可滚动,把拖动手柄限制在标题区,避免内容滚动与调整高度争抢手势。


