Flutter里面的布局都是由各种widget组成的,所以有必要熟悉一下各种widget
基础 Widgets
名称 | 介绍 |
---|---|
Container | 一个拥有绘制、定位、调整大小的 widget。 |
Row | 在水平方向上排列子widget的列表。 |
Column | 在垂直方向上排列子widget的列表。 |
Image | 一个显示图片的widget |
Text | 单一格式的文本 |
Icon | A Material Design icon. |
RaisedButton | Material Design中的button, 一个凸起的材质矩形按钮 |
Scaffold | Material Design布局结构的基本实现。此类提供了用于显示drawer、snackbar和底部sheet的API。 |
Appbar | 一个Material Design应用程序栏,由工具栏和其他可能的widget(如TabBar和FlexibleSpaceBar)组成。 |
FlutterLogo | Flutter logo, 以widget形式. 这个widget遵从IconTheme。 |
Placeholder | 一个绘制了一个盒子的的widget,代表日后有widget将会被添加到该盒子中 |
Material Components Widgets
App结构和导航
名称 | 介绍 |
---|---|
Scaffold | Material Design布局结构的基本实现。此类提供了用于显示drawer、snackbar和底部sheet的API。 |
Appbar | 一个Material Design应用程序栏,由工具栏和其他可能的widget(如TabBar和FlexibleSpaceBar)组成。 |
BottomNavigationBar | 底部导航条,可以很容易地在tap之间切换和浏览顶级视图。 |
TabBar | 一个显示水平选项卡的Material Design widget。 |
TabBarView | 显示与当前选中的选项卡相对应的页面视图。通常和TabBar一起使用。 |
MaterialApp | 一个方便的widget,它封装了应用程序实现Material Design所需要的一些widget。 |
WidgetsApp | 一个方便的类,它封装了应用程序通常需要的一些widget。 |
按钮
名称 | 介绍 |
---|---|
RaisedButton | Material Design中的button, 一个凸起的材质矩形按钮 |
FloatingActionButton | 一个圆形图标按钮,它悬停在内容之上,以展示应用程序中的主要动作。FloatingActionButton通常用于Scaffold.floatingActionButton字段。 |
FlatButton | 一个扁平的Material按钮 |
IconButton | 一个Material图标按钮,点击时会有水波动画 |
PopupMenuButton | 当菜单隐藏式,点击或调用onSelected时显示一个弹出式菜单列表 |
ButtonBar | 水平排列的按钮组 |
输入框和选择框
名称 | 介绍 |
---|---|
TextField | 文本输入框 |
Checkbox | 复选框,允许用户从一组中选择多个选项。 |
Radio | 单选框,允许用户从一组中选择一个选项。 |
Switch | On/off 用于切换一个单一状态 |
Slider | 滑块,允许用户通过滑动滑块来从一系列值中选择。 |
Date & Time Pickers | 日期&时间选择器 |
对话框、Alert、Panel
名称 | 介绍 |
---|---|
SimpleDialog | 简单对话框可以显示附加的提示或操作 |
AlertDialog | 一个会中断用户操作的对话款,需要用户确认 |
BottomSheet | BottomSheet是一个从屏幕底部滑起的列表(以显示更多的内容)。你可以调用showBottomSheet()或showModalBottomSheet弹出 |
ExpansionPanel | Expansion panels contain creation flows and allow lightweight editing of an element. The ExpansionPanel widget implements this component. |
SnackBar | 具有可选操作的轻量级消息提示,在屏幕的底部显示。 |
信息展示
名称 | 介绍 |
---|---|
Image | 一个显示图片的widget |
Icon | A Material Design icon. |
Chip | 标签,一个Material widget。 它可以将一个复杂内容实体展现在一个小块中,如联系人。 |
Tooltip | 一个文本提示工具,帮助解释一个按钮或其他用户界面,当widget长时间按下时(当用户采取其他适当操作时)显示一个提示标签。 |
DataTable | 数据表显示原始数据集。它们通常出现在桌面企业产品中。DataTable Widget实现这个组件 |
Card | 一个 Material Design 卡片。拥有一个圆角和阴影 |
LinearProgressIndicator | 一个线性进度条,另外还有一个圆形进度条CircularProgressIndicator |
布局
名称 | 介绍 |
---|---|
ListTile | 一个固定高度的行,通常包含一些文本,以及一个行前或行尾图标。 |
Stepper | 一个Material Design 步骤指示器,显示一系列步骤的过程 |
Divider | 一个逻辑1像素厚的水平分割线,两边都有填充 |
Cupertino (iOS风格) Widgets
名称 | 介绍 |
---|---|
CupertinoActivityIndicator | 一个iOS风格的loading指示器。显示一个圆形的转圈菊花 |
CupertinoAlertDialog | iOS风格的alert dialog. |
CupertinoButton | iOS风格的button. |
CupertinoDialog | iOS风格的对话框 |
CupertinoDialogAction | 通常用于CupertinoAlertDialog的一个button |
CupertinoSlider | 从一个范围中选一个值. |
CupertinoSwitch | iOS风格的开关. 用于单一状态的开/关 |
CupertinoPageTransition | 提供iOS风格的页面过度动画 |
CupertinoFullscreenDialogTransition | 一个iOS风格的过渡,用于调用全屏对话框。 |
CupertinoNavigationBar | iOS风格的导航栏. 通常和CupertinoPageScaffold一起使用。 |
CupertinoTabBar | iOS风格的底部选项卡。 通常和CupertinoTabScaffold一起使用。 |
CupertinoPageScaffold | 一个iOS风格的页面的基本布局结构。包含内容和导航栏 |
CupertinoTabScaffold | 标签式iOS应用程序的结构。将选项卡栏放在内容选项卡之上 |
CupertinoTabView | 支持选项卡间并行导航项卡的根内容。通常与CupertinoTabScaffolde一起使用 |
拥有单个子元素的布局widget
名称 | 介绍 |
---|---|
Container | 一个拥有绘制、定位、调整大小的 widget。 |
Padding | 一个widget, 会给其子widget添加指定的填充 |
Center | 将其子widget居中显示在自身内部的widget |
Align | 一个widget,它可以将其子widget对齐,并可以根据子widget的大小自动调整大小。 |
FittedBox | 按自己的大小调整其子widget的大小和位置。 |
AspectRatio | 一个widget,试图将子widget的大小指定为某个特定的长宽比 |
ConstrainedBox | 对其子项施加附加约束的widget |
Baseline | 根据子项的基线对它们的位置进行定位的widget。 |
FractionallySizedBox | 一个widget,它把它的子项放在可用空间的一小部分。关于布局算法的更多细节,见RenderFractionallySizedOverflowBox |
IntrinsicHeight | 一个widget,它将它的子widget的高度调整其本身实际的高度 |
IntrinsicWidth | 一个widget,它将它的子widget的宽度调整其本身实际的宽度 |
LimitedBox | 一个当其自身不受约束时才限制其大小的盒子 |
Offstage | 一个布局widget,可以控制其子widget的显示和隐藏。 |
OverflowBox | 对其子项施加不同约束的widget,它可能允许子项溢出父级。 |
SizedBox | 一个特定大小的盒子。这个widget强制它的孩子有一个特定的宽度和高度。如果宽度或高度为NULL,则此widget将调整自身大小以匹配该维度中的孩子的大小。 |
SizedOverflowBox | 一个特定大小的widget,但是会将它的原始约束传递给它的孩子,它可能会溢出。 |
Transform | 在绘制子widget之前应用转换的widget。 |
CustomSingleChildLayout | 一个自定义的拥有单个子widget的布局widget |
拥有多个子元素的布局widget
名称 | 介绍 |
---|---|
Row | 在水平方向上排列子widget的列表。 |
Column | 在垂直方向上排列子widget的列表。 |
Stack | 可以允许其子widget简单的堆叠在一起 |
IndexedStack | 从一个子widget列表中显示单个孩子的Stack |
Flow | 一个实现流式布局算法的widget |
Table | 为其子widget使用表格布局算法的widget |
Wrap | 可以在水平或垂直方向多行显示其子widget。 |
ListBody | 一个widget,它沿着一个给定的轴,顺序排列它的子元素 |
ListView | 可滚动的列表控件。ListView是最常用的滚动widget,它在滚动方向上一个接一个地显示它的孩子。在纵轴上,孩子们被要求填充ListView。 |
CustomMultiChildLayout | 使用一个委托来对多个孩子进行设置大小和定位的小部件 |
Layout helpers
名称 | 介绍 |
---|---|
Layout helpers | 构建一个可以依赖父窗口大小的widget树。 |
文本 Widget
名称 | 介绍 |
---|---|
Text | 单一格式的文本 |
RichText | 一个富文本Text,可以显示多种样式的text。 |
DefaultTextStyle | 文字样式,用于指定Text widget的文字样式 |
Assets、Images、Icon
名称 | 介绍 |
---|---|
Image | 一个显示图片的widget |
Icon | A Material Design icon. |
RawImage | 一个直接显示dart:ui.Image的widget |
AssetBundle | 包含应用程序可以使用的资源,如图像和字符串。对这些资源的访问是异步,所以他们可以来自网络(例如,从NetworkAssetBundle)或从本地文件系统,这并不会挂起用户界面。 |
表单 Widgets
名称 | 介绍 |
---|---|
Form | 一个可选的、用于给多个TextField分组的widget |
FormField | 一个单独的表单字段。此widget维护表单字段的当前状态,以便在UI中直观地反映更新和验证错误。 |
RawKeyboardListener | 每当用户按下或释放键盘上的键时调用回调的widget。 |
动画&Motion Widget
名称 | 介绍 |
---|---|
AnimatedContainer | 在一段时间内逐渐改变其值的容器。 |
AnimatedCrossFade | 一个widget,在两个孩子之间交叉淡入,并同时调整他们的尺寸 |
Hero | 将其子项标记为hero动画候选的widget。 |
AnimatedBuilder | 用于构建动画的通用小部件。AnimatedBuilder在有多个widget希望有一个动画作为一个较大的建造函数部分时会非常有用。要使用AnimatedBuilder,只需构建widget并将其传给builder函数即可。 |
DecoratedBoxTransition | DecoratedBox的动画版本,可以给它的Decoration不同属性使用动画 |
FadeTransition | 对透明度使用动画的widget |
PositionedTransition | Positioned的动画版本,它需要一个特定的动画来将孩子的位置从动画的生命周期的起始位置移到结束位置。 |
RotationTransition | 对widget使用旋转动画 |
ScaleTransition | 对widget使用缩放动画 |
SizeTransition | Animates its own size and clips and aligns the child. |
SlideTransition | 对相对于其正常位置的某个位置之间使用动画 |
AnimatedDefaultTextStyle | 在文本样式切换时使用动画 |
AnimatedListState | 动画列表的state |
AnimatedModalBarrier | 一个阻止用户与widget交互的widget |
AnimatedOpacity | Opacity的动画版本,在给定的透明度变化时,自动地在给定的一段时间内改变孩子的Opacity |
AnimatedPhysicalModel | PhysicalModel的动画版本 |
AnimatedPositioned | 动画版本的Positioned,每当给定位置的变化,自动在给定的时间内转换孩子的位置。 |
AnimatedSize | 动画widget,当给定的孩子的大小变化时,它自动地在给定时间内转换它的大小。 |
AnimatedWidget | 当给定的Listenable改变值时,会重新构建该widget |
AnimatedWidgetBaseState | 具有隐式动画的widget的基类 |
交互模型Widget
名称 | 介绍 |
---|---|
LongPressDraggable | 可以使其子widget在长按时可拖动 |
GestureDetector | 一个检测手势的widget |
DragTarget | 一个拖动的目标widget,在完成拖动时它可以接收数据 |
Dismissible | 可以在拖动时隐藏的widget |
IgnorePointer | 在hit test中不可见的widget。当ignoring为true时,此widget及其子树不响应事件。但它在布局过程中仍然消耗空间,并像往常一样绘制它的孩子。它是无法捕获事件对象、因为它在RenderBox.hitTest中返回false |
AbsorbPointer | 在hit test期间吸收(拦截)事件。当absorbing为true时,此小部件阻止其子树通过终止命中测试来接收指针事件。它在布局过程中仍然消耗空间,并像往常一样绘制它的孩子。它只是防止其孩子成为事件命中目标,因为它从RenderBox.hitTest返回true。 |
Navigator | 导航器,可以在多个页面(路由)栈之间跳转。 |
Scrollable | 实现了可滚动widget的交互模型,但不包含UI显示相关的逻辑 |
样式 Widget
名称 | 介绍 |
---|---|
Padding | 一个widget, 会给其子widget添加指定的填充 |
Theme | 将主题应用于子widget。主题描述了应用选择的颜色和字体。 |
MediaQuery | 建立一个子树,在树中媒体查询解析不同的给定数据 |
绘制和视觉效果Widget
名称 | 介绍 |
---|---|
Opacity | 使其子widget透明的widget。 |
Transform | 在绘制子widget之前应用转换的widget。 |
DecoratedBox | 在孩子绘制之前或之后绘制装饰的widget。 |
FractionalTranslation | 绘制盒子之前给其添加一个偏移转换 |
RotatedBox | 可以延顺时针以90度的倍数旋转其子widget |
ClipOval | 用椭圆剪辑其孩子的widget |
ClipPath | 用path剪辑其孩子的widget |
ClipRect | 用矩形剪辑其孩子的widget |
CustomPaint | 提供一个画布的widget,在绘制阶段可以在画布上绘制自定义图形 |
BackdropFilter | 一个widget,它将过滤器应用到现有的绘图内容,然后绘制孩子。这种效果是比较昂贵的,尤其是如果过滤器是non-local,如blur。 |
异步 Widgets
名称 | 介绍 |
---|---|
FutureBuilder | 基于与Future交互的最新快照来构建自身的widget |
StreamBuilder | 基于与流交互的最新快照构建自身的widget |
可滚动的Widget
名称 | 介绍 |
---|---|
ListView | 一个可滚动的列表 |
NestedScrollView | 一个可以嵌套其它可滚动widget的widget |
GridView | 一个可滚动的二维空间数组 |
SingleChildScrollView | 有一个子widget的可滚动的widget,子内容超过父容器时可以滚动。 |
Scrollable | 实现了可滚动widget的交互模型,但不包含UI显示相关的逻辑 |
Scrollbar | 一个Material Design 滚动条,表示当前滚动到了什么位置 |
CustomScrollView | 一个使用slivers创建自定义的滚动效果的ScrollView |
NotificationListener | 一个用来监听树上冒泡通知的widget。 |
ScrollConfiguration | 控制可滚动组件在子树中的表现行为 |
RefreshIndicator | Material Design下拉刷新指示器,包装一个可滚动widget |
辅助功能 Widget
名称 | 介绍 |
---|---|
Semantics | 一个widget,用以描述widget树的具体语义。使用辅助工具、搜索引擎和其他语义分析软件来确定应用程序的含义。 |
MergeSemantics | 合并其后代语义的widget。 |
ExcludeSemantics | 删除其后代所有语义的widget |
简单得对各个控件得一个描述,后面应该会对一些常用的控件进行使用介绍