Material Design是由谷歌推出的全新设计语言,这种设计语言旨在为手机、平板电脑、台式机和其他平台提供更一致、更广泛的外观和感觉。Material Design风格是一直非常有质感的设计风格,并会提供一些默认的交互动画。
MaterialApp代表使用Material Design风格的应用,里面包含了其他所需的基本控件。官方提供的示例demo就是从MaterialApp这个主组件开始的。
MaterialApp组件常见属性
属性名 | 类型 | 说明 |
---|---|---|
title | String | 应用程序的标题。该标题出现在以下位置:Android:任务管理器的程序快照上; IOS:程序切换管理器中 |
theme | ThemeData | 定义应用所使用的主题颜色,可以指定主题中每个控件的颜色 |
color | Color | 应用的主要颜色值,即primary color |
home | Widget | 用来定义当前应用打开时所显示的界面 |
routes | Map<String, WidgetBuilder> | 定义应用中页面跳转规则 |
initialRoute | String | 初始化路由 |
onGenerateRoute | RouteFactory | 路由回调函数。当通过Navigator.of(context).pushNamed跳转路由的时候,在routes查找不到时,会调用该方法 |
onLocaleChanged | - | 当系统修改语言的时候,会触发这个回调 |
navigatorObservers | List<NavigatorObserver> | 导航观察器 |
debugShowMaterialGrid | bool | 是否显示布局网格,用来调试UI的工具 |
showPerformanceOverlay | bool | 显示性能标签 |
使用home属性设置应用的主页,即整个应用的主组件。
routes对象是一个Map<String, WidgetBuilder>。当使用Navigator.pushNamed来跳转路由的时候,通过routes查找路由名字,然后使用对应的WidgetBuilder来构造一个带有页面切换动画的MaterialPageRoute。如果应用只有一个界面,则不用设置整个属性,使用home即可。
应用程序的主题,各种定制的颜色都可以设置,用于程序主题切换。
Scaffold实现了基本的Material Design布局。只要是在Material Design中定义过的单个界面显示的布局组件元素,都可以使用Scaffold来绘制。
常用属性
属性名 | 类型 | 说明 |
---|---|---|
appBar | AppBar | 显示在界面顶部的一个AppBar |
body | Widget | 当前界面所显示的主要内容 |
floatingActionButton | Widget | 在Material Design中定义的一个功能按钮 |
persistentFooterButtons | List< Widget> | 固定在下方显示的按钮 |
drawer | Widget | 侧边栏组件 |
bottomNavigatorBar | Widget | 显示在底部的导航栏 |
backgroudColor | Color | 背景颜色 |
resizeToAvoidBottomPadding | bool | 控制界面内容body是否重新布局来避免底部被覆盖,比如当键盘显示时,重新布局避免键盘盖住内容。默认为true |
应用按钮组件有AppBar和SliverAppBar。它们是Material Design中的AppBar,也就是Android中的ToolBar。
AppBar和SliverAppBar都继承自StatefulWidget,两者的区别在于AppBar的位置是固定在应用最上面的;而SliverAppBar是可以跟随内容滚动的。
常用属性
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
leading | Widget | null | 在标题前面显示一个组件,在首页通常显示应用的logo;其他界面通常显示返回按钮 |
title | Widget | null | 当前界面的标题 |
actions | List<Widget> | null | 一个Widget列表,常用菜单通常使用IconButton,不常用的通常使用PopupMenuButton显示三个点,点击后弹出二级菜单 |
bottom | PreferredSizeWidget | null | 通常是一个TabBar。用来在标题下方显示一个Tab导航栏 |
elevation | double | 4 | 控制AppBar下方阴影的高度 |
flexibleSpace | Widget | null | 一个显示在AppBar下方的组件,高度和AppBar一样,可以实现一些特殊的效果,该属性通常在SliverAppBar中使用 |
backgroundColor | Color | ThemeData.primaryColor | 背景色 |
brightness | Brightness | ThemeData.primaryColorBrightness | AppBar的亮度,有白色和黑色两种主题 |
iconTheme | IconThemeData | ThemeData.primaryIconTheme | AppBar上图标的颜色、透明度和尺寸信息 |
textTheme | TextTheme | ThemeData.primaryTextTheme | AppBar上文字样式 |
centerTitle | bool | - | 标题是否居中显示,不同操作系统,显示方式不一样 |
BottomNavigatorBar是底部导航栏,可以很容易地在tab之间切换和浏览顶级视图。
常见属性
属性名 | 类型 | 说明 |
---|---|---|
currentIndex | int | 当前索引 |
fixedColor | Color | 选中按钮的颜色。不指定则使用系统主题色 |
iconSize | double | 按钮图形大小 |
items | List<BottomNavigatorBarItem> | 底部导航栏按钮集。每一项是一个BottomNavigatorBarItem,包含icon图标和title文本 |
onTap | ValueChanged<int> | 按下按钮的回调事件。需要根据返回的索引设置当前索引 |
TabBar是一个显示水平选项卡的Material Design组件,通常需要配套Tab选项组件及TabBarView页面视图组件一起使用。
TabBar常见属性
属性名 | 类型 | 说明 |
---|---|---|
isScrolled | bool | 是否可以水平滚动 |
tabs | List<Widget> | Tab选项列表 |
Tab常见属性
属性名 | 类型 | 说明 |
---|---|---|
icon | Widget | Tab图标 |
text | String | Tab文本 |
TabBarView常见属性
属性名 | 类型 | 说明 |
---|---|---|
controller | TabController | 指定视图的控制器 |
childrens | List<Widget> | 视图组件的child为一个列表,一个选项卡对应一个视图 |
Drawer可以实现类似抽屉拉入推出的效果,通常与ListView组合使用。
Drawer常用属性
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
child | Widget | - | Drawer的child可以放置任意可显示的组件 |
elevation | double | 16 | 阴影尺寸 |
Drawer可以添加头部效果:
- DrawerHeader:展示基本信息
- UserAccountsDrawerHeader:展示用户头像、用户名、Email等信息
DrawerHeader常用属性
属性名 | 类型 | 说明 |
---|---|---|
decoration | Decoration | header区域的decoration,通常用来设置背景颜色或背景图片 |
curve | Curve | 如果decoration发生了变化,则会使用curve设置的变化曲线和duration设置的动画时间来做一个动画效果 |
child | Widget | Header里面所显示的内容控件 |
padding | EdgeInsetsGeometry | Header里面内容控件的padding值,如果child为null,该值无效 |
margin | EdgeInsetsGeometry | Header四周的间隙 |
UserAccountsDrawerHeader常用属性
属性名 | 类型 | 说明 |
---|---|---|
margin | EdgeInsetsGeometry | Header四周的间隙 |
decoration | Decoration | header区域的decoration,通常用来设置背景颜色或背景图片 |
currentAccountPicture | Widget | 用来设置当前用户的头像 |
otherAccountsPicture | Widget | 用来设置当前用户其他账号的头像 |
accountName | Widget | 当前用户的名字 |
accountEmail | Widget | 当前用户的Email |
onDetailsPressed | VoidCallback | 当accountName或者accountEmail被点击的时候所触发的回调函数,可以用来显示其他额外的信息 |
FloatingActionButton对应一个圆形图标按钮,悬停在内容之上,以展示应用程序中的主要动作。类似IOS里的小白点。
FloatingActionButton常用属性
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
child | - | - | - |
tooltip | - | - | - |
foregroundColor | - | - | - |
backgroundColor | - | - | - |
elevation | - | - | - |
highlightElevation | - | - | - |
onPressed | - | - | - |
shape | - | - | - |
FlatButton是一个扁平的Material Design风格的按钮,点击时会有一个阴影效果。
PopupMenuButton一般放在应用右上角,表示更多操作,菜单项使用PopupMenuItem组件。
PopupMenuButton常用属性
属性名 | 类型 | 说明 |
---|---|---|
child | - | - |
icon | - | - |
itemBuilder | - | - |
onSelected | - | - |
SimpleDialog用于设计简单的对话框,可以显示附加的提示或操作。SimpleDialog通常需要配合SimpleDialogOption组件一起使用。
SimpleDialog常用属性
属性名 | 类型 | 说明 |
---|---|---|
children | List<Widget> | 对话框子项 |
title | Widget | 通常是一个文本控件 |
contentPadding | EdgeInsetsGeometry | 内容部分间距 |
titlePadding | EdgeInsetsGeometry | 标题部分间距 |
- 通常对话框都是由某个动作来触发渲染的,比如点击按钮,点击菜单等。所以对话框一般要封装在一个方法里实现。
- 另外这个过程是异步的需要加入async/await处理。
AlertDialog比SimpleDialog对话框又复杂一些,不仅有提示内容,还有一些操作按钮,如确定和取消等,内容部分可以用SingleChildScrollView进行包裹。
AlertDialog常用属性
属性名 | 类型 | 说明 |
---|---|---|
actions | List<Widget> | 对话框底部操作按钮,如确定、取消等 |
title | Widget | 通常是一个文本控件 |
contentPadding | EdgeInsetsGeometry | 内容部分间距 |
content | Widget | 内容部分,通常为对话框的提示内容 |
titlePadding | EdgeInsetsGeometry | 标题部分间距 |
SnackBar是一个轻量级消息提示组件,在屏幕底部显示。
SnackBar常用属性
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
action | SnackBarAction | - | 提示消息里执行的动作,比如用户想撤销时可以点击操作 |
animation | Animation<double> | - | 给组件添加动画效果 |
content | Widget | - | 提示消息内容,通常为文本组件 |
duration | Duration | 4.0秒 | 动画执行的时长 |
backgroundColor | Color | - | 消息面板的背景色 |
TextField就是用来做文本输入的组件。
- 注意与Text组件区分,Text主要用于显示文本,不接受文本输入。
TextField常用属性
属性名 | 类型 | 说明 |
---|---|---|
maxLength | int | 最大长度 |
maxLines | int | 最大行数 |
autocorrect | bool | 是否自动更正 |
autofocus | bool | 是否自动对焦 |
obscureText | bool | 是否是密码 |
textAlign | TextAlign | 文本对齐方式 |
style | TextStyle | 文本的样式 |
inputFormatters | List<TextInputFormatter> | 允许的输入格式 |
onChanged | VoidChanged<String> | 内容改变时回调 |
onSubmitted | VoidChanged<String> | 内容提交时回调 |
enabled | bool | 是否禁用 |
Card内容可以由大多数类型的组件构成,但通常与ListTitle一起使用。Card有一个child,但可以是支持多个child的Row、Column、ListView、GridView或其他小部件。默认情况下,Card将其大小缩小为0像素。可以使用SizedBox来限制Card的大小。
Card常用属性
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
child | Widget | - | 组件的子元素,任意Widget都可以 |
margin | EdgeInsetsGeometry | - | 围绕在decoration和child之外的空白区域,不属于内容区域 |
shape | ShapeBorder | RoundedRectangleBorder | Card的阴影效果,默认的阴影效果为圆角的长方形边。弧度为4.0 |