当前位置：首页 > news >正文

Flutter 中 DraggableScrollableSheet 的属性介绍与使用

news 2025/7/1 2:18:12

在 Flutter 中，DraggableScrollableSheet 是一个非常有用的小部件，它允许用户通过手势来拖动一个可滚动的区域，通常被用作底部弹出式面板或者随手势拖动的控件。本文将介绍 DraggableScrollableSheet 的属性以及如何在 Flutter 中使用它。

DraggableScrollableSheet 属性介绍

initialChildSize: 设置 DraggableScrollableSheet 初始时的高度占屏幕的比例。范围为 0 到 1，默认值为 0.5（即初始高度为屏幕高度的一半）。
minChildSize: 指定 DraggableScrollableSheet 的最小高度占屏幕的比例。默认为 0，表示没有最小高度限制。
maxChildSize: 指定 DraggableScrollableSheet 的最大高度占屏幕的比例。默认为 1，表示没有最大高度限制。
expand: 设置是否允许 DraggableScrollableSheet 在内容小于屏幕高度时扩展以填充屏幕。默认为 true。
snap: 一个布尔值，用于控制是否启用 DraggableScrollableSheet 在滚动停止时自动"捕捉"到接近的最小或最大值。默认值为 false。
builder: 一个构建函数，用于构建 DraggableScrollableSheet 的内容。该函数接受两个参数：BuildContext 和 ScrollController，返回一个 Widget，通常是一个 SingleChildScrollView 或者 ListView。

如何使用 DraggableScrollableSheet

下面是一个简单的示例，展示了如何在 Flutter 中使用 DraggableScrollableSheet：

import 'package:flutter/material.dart';void main() {runApp(MyApp());
}class MyApp extends StatelessWidget {@overrideWidget build(BuildContext context) {return MaterialApp(home: Scaffold(appBar: AppBar(title: Text('DraggableScrollableSheet Example'),),body: MyHomePage(),),);}
}class MyHomePage extends StatelessWidget {@overrideWidget build(BuildContext context) {return Center(child: ElevatedButton(onPressed: () {showModalBottomSheet(context: context,builder: (context) {return DraggableScrollableSheet(initialChildSize: 0.5,minChildSize: 0.25,maxChildSize: 0.75,expand: true,snap: true,builder: (context, scrollController) {return Container(color: Colors.grey[300],child: ListView.builder(controller: scrollController,itemCount: 25,itemBuilder: (context, index) {return ListTile(title: Text('Item $index'),);},),);},);},);},child: Text('Show DraggableScrollableSheet'),),);}
}