Flutter构建完整应用手册设计基础知识

这本食谱包含演示如何在写Flutter应用程序时解决常见问题的食谱。 每个配方都是独立的&＃xff0c;可以作为参考帮助您构建应用程序。

使用主题共享颜色和字体样式

为了在整个应用中共享颜色和字体样式&＃xff0c;我们可以利用主题。定义主题有两种方式&＃xff1a;应用程序范围或使用Theme小部件来定义应用程序特定部分的颜色和字体样式。事实上&＃xff0c;应用程序范围的主题只是由MaterialApp在应用程序根部创建的主题小部件&＃xff01;

在我们定义一个主题后&＃xff0c;我们可以在自己的部件中使用它。另外&＃xff0c;Flutter提供的Material Widgets将使用我们的主题为AppBars&＃xff0c;Buttons&＃xff0c;Checkboxes等设置背景颜色和字体样式。

创建应用主题

为了在整个应用程序中共享包含颜色和字体样式的主题&＃xff0c;我们可以将ThemeData提供给MaterialApp构造函数。

如果没有提供Theme&＃xff0c;Flutter将在后台创建一个后备主题。

new MaterialApp(title: title,theme: new ThemeData(brightness: Brightness.dark,primaryColor: Colors.lightBlue[800],accentColor: Colors.cyan[600],),
);

请参阅ThemeData文档以查看您可以定义的所有颜色和字体。

部分应用程序的主题

如果我们想在我们的应用程序的一部分中覆盖应用程序范围的主题&＃xff0c;我们可以将我们的应用程序的一部分包装在Theme小部件中。

有两种方法可以解决这个问题&＃xff1a;创建唯一的ThemeData&＃xff0c;或者扩展父主题。

创建唯一的ThemeData

如果我们不想继承任何应用程序的颜色或字体样式&＃xff0c;我们可以创建一个新的ThemeData&＃xff08;&＃xff09;实例并将其传递给Theme部件。

new Theme(// Create a unique theme with "new ThemeData"data: new ThemeData(accentColor: Colors.yellow,),child: new FloatingActionButton(onPressed: () {},child: new Icon(Icons.add),),
);

扩展父主题

扩展父主题通常是有意义的&＃xff0c;而不是覆盖所有。 我们可以通过使用copyWith方法来实现这一点。

new Theme(// Find and Extend the parent theme using "copyWith". Please see the next // section for more info on &＃96;Theme.of&＃96;.data: Theme.of(context).copyWith(accentColor: Colors.yellow),child: new FloatingActionButton(onPressed: null,child: new Icon(Icons.add),),
);

使用主题

现在我们已经定义了一个主题&＃xff0c;我们可以使用Theme.of(context)函数在我们的部件build方法中使用它&＃xff01;

Theme.of(context)将查找部件树并返回树中最近的Theme。 如果我们的部件上方定义了独立的Theme&＃xff0c;则返回该Theme。 如果不是&＃xff0c;则返回应用程序范围Theme。

实际上&＃xff0c;FloatingActionButton使用这种精确的技术来查找accentColor&＃xff01;

new Container(color: Theme.of(context).accentColor,child: new Text(&＃39;Text with a background color&＃39;,style: Theme.of(context).textTheme.title,),
);

完整的例子

import &＃39;package:flutter/foundation.dart&＃39;;
import &＃39;package:flutter/material.dart&＃39;;void main() {runApp(new MyApp());
}class MyApp extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {final appName &＃61; &＃39;Custom Themes&＃39;;return new MaterialApp(title: appName,theme: new ThemeData(brightness: Brightness.dark,primaryColor: Colors.lightBlue[800],accentColor: Colors.cyan[600],),home: new MyHomePage(title: appName,),);}
}class MyHomePage extends StatelessWidget {final String title;MyHomePage({Key key, &＃64;required this.title}) : super(key: key);&＃64;overrideWidget build(BuildContext context) {return new Scaffold(appBar: new AppBar(title: new Text(title),),body: new Center(child: new Container(color: Theme.of(context).accentColor,child: new Text(&＃39;Text with a background color&＃39;,style: Theme.of(context).textTheme.title,),),),floatingActionButton: new Theme(data: Theme.of(context).copyWith(accentColor: Colors.yellow),child: new FloatingActionButton(onPressed: null,child: new Icon(Icons.add),),),);}
}

显示SnackBars

在某些情况下&＃xff0c;当发生某些操作时可以方便地向用户简单通知。 例如&＃xff0c;当用户在列表中删除消息时&＃xff0c;我们可能想通知他们消息已被删除。 我们甚至可能想给他们一个撤消行为的选择&＃xff01;

在Material Design中&＃xff0c;这是SnackBar的工作。

路线

1. 创建一个Scaffold
2. 显示一个SnackBar
3. 提供额外的操作

1.创建一个Scaffold

在创建遵循材质设计指南的应用程序时&＃xff0c;我们希望为我们的应用程序提供一致的可视化结构。 在这种情况下&＃xff0c;我们需要在屏幕底部显示SnackBar&＃xff0c;而不会与其它重要的部件重叠&＃xff0c;例如FloatingActionButton&＃xff01;

材料库中的Scaffold部件为我们创建了这个视觉结构&＃xff0c;并确保重要的部件不会重叠&＃xff01;

new Scaffold(appBar: new AppBar(title: new Text(&＃39;SnackBar Demo&＃39;),),body: new SnackBarPage(), // We&＃39;ll fill this in below!
);

2.显示一个SnackBar

使用Scaffold&＃xff0c;我们可以展示SnackBar&＃xff01; 首先&＃xff0c;我们需要创建一个SnackBar&＃xff0c;然后使用Scaffold显示它。

final snackBar &＃61; new SnackBar(content: new Text(&＃39;Yay! A SnackBar!&＃39;));// Find the Scaffold in the Widget tree and use it to show a SnackBar
Scaffold.of(context).showSnackBar(snackBar);

3.提供额外的操作

在某些情况下&＃xff0c;我们可能希望在显示SnackBar时向用户提供额外的操作。 例如&＃xff0c;如果他们意外删除了一条消息&＃xff0c;我们可以提供撤消该更改的操作。

为了达到这个目的&＃xff0c;我们可以为SnackBar部件提供额外的action。

final snackBar &＃61; new SnackBar(content: new Text(&＃39;Yay! A SnackBar!&＃39;),action: new SnackBarAction(label: &＃39;Undo&＃39;,onPressed: () {// Some code to undo the change!},),
);

完整的例子

注意&＃xff1a;在本例中&＃xff0c;我们将在用户点击按钮时显示SnackBar。 有关处理用户输入的更多信息&＃xff0c;请参阅食谱的处理手势部分。

import &＃39;package:flutter/material.dart&＃39;;void main() &＃61;> runApp(new SnackBarDemo());class SnackBarDemo extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new MaterialApp(title: &＃39;SnackBar Demo&＃39;,home: new Scaffold(appBar: new AppBar(title: new Text(&＃39;SnackBar Demo&＃39;),),body: new SnackBarPage(),),);}
}class SnackBarPage extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new Center(child: new RaisedButton(onPressed: () {final snackBar &＃61; new SnackBar(content: new Text(&＃39;Yay! A SnackBar!&＃39;),action: new SnackBarAction(label: &＃39;Undo&＃39;,onPressed: () {// Some code to undo the change!},),);// Find the Scaffold in the Widget tree and use it to show a SnackBar!Scaffold.of(context).showSnackBar(snackBar);},child: new Text(&＃39;Show SnackBar&＃39;),),);}
}

使用选项卡

使用选项卡是遵循Material Design指南的应用程序中的常见模式。 Flutter包含创建选项卡布局作为材料库的一部分的便捷方式。

路线

1. 创建一个TabController

2. 创建选项卡

3. 为每个选项卡创建内容

1.创建一个TabController

为了让选项卡工作&＃xff0c;我们需要保持所选选项卡和内容部分的同步。 这是TabController的工作。

我们可以手动创建TabController或使用DefaultTabController部件。 使用DefaultTabController是最简单的选择&＃xff0c;因为它会为我们创建一个TabController并使其可供所有后代控件使用。

new DefaultTabController(// The number of tabs / content sections we need to displaylength: 3,child: // See the next step!
);

2.创建选项卡

既然我们有一个TabController可以使用&＃xff0c;我们可以使用TabBar部件创建我们的选项卡。 在这个例子中&＃xff0c;我们将创建一个带有3个Tab小部件的TabBar&＃xff0c;并将其放置在AppBar中。

new DefaultTabController(length: 3,child: new Scaffold(appBar: new AppBar(bottom: new TabBar(tabs: [new Tab(icon: new Icon(Icons.directions_car)),new Tab(icon: new Icon(Icons.directions_transit)),new Tab(icon: new Icon(Icons.directions_bike)),],),),),
);

默认情况下&＃xff0c;TabBar查找最近的DefaultTabController的部件树。 如果你手动创建一个TabController&＃xff0c;你需要将它传递给TabBar。

3.为每个选项卡创建内容

现在我们有了选项卡&＃xff0c;我们希望在选择标签时显示内容。 为此&＃xff0c;我们将使用TabBarView部件。

注意&＃xff1a;顺序很重要&＃xff0c;必须与TabBar中的选项卡顺序相对应&＃xff01;

new TabBarView(children: [new Icon(Icons.directions_car),new Icon(Icons.directions_transit),new Icon(Icons.directions_bike),],
);

完整实例

import &＃39;package:flutter/material.dart&＃39;;void main() {runApp(new TabBarDemo());
}class TabBarDemo extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new MaterialApp(home: new DefaultTabController(length: 3,child: new Scaffold(appBar: new AppBar(bottom: new TabBar(tabs: [new Tab(icon: new Icon(Icons.directions_car)),new Tab(icon: new Icon(Icons.directions_transit)),new Tab(icon: new Icon(Icons.directions_bike)),],),title: new Text(&＃39;Tabs Demo&＃39;),),body: new TabBarView(children: [new Icon(Icons.directions_car),new Icon(Icons.directions_transit),new Icon(Icons.directions_bike),],),),),);}
}

使用自定义字体

虽然Android和iOS提供高质量的系统字体&＃xff0c;但设计师最常见的要求之一是使用自定义字体&＃xff01; 例如&＃xff0c;我们可能会从我们的设计人员那里获得一个定制的字体&＃xff0c;或者从谷歌字体中下载一种字体。

Flutter使用自定义字体开箱即用。 我们可以将字体应用到整个应用程序或个别小部件。

路线

• 导入字体文件
• 在pubspec.yaml中声明该字体
• 将字体设置为默认值
• 在特定的部件中使用字体

1.导入字体文件

为了处理字体&＃xff0c;我们需要将字体文件导入到项目中。 将字体文件放在Flutter项目的根目录下的fonts或assets文件夹中是很常见的做法。

例如&＃xff0c;如果我们想将Raleway和Roboto Mono字体文件导入到我们的项目中&＃xff0c;那么文件夹结构如下所示&＃xff1a;

awesome_app/fonts/Raleway-Regular.ttfRaleway-Italic.ttfRobotoMono-Regular.ttfRobotoMono-Bold.ttf

2.在pubspec.yaml中声明该字体

现在我们有一个可以使用的字体&＃xff0c;我们需要告诉Flutter在哪里找到它。 我们可以通过在pubspec.yaml中包含一个字体定义来实现。

flutter:fonts:- family: Ralewayfonts:- asset: fonts/Raleway-Regular.ttf- asset: fonts/Raleway-Italic.ttfstyle: italic- family: RobotoMonofonts:- asset: fonts/RobotoMono-Regular.ttf- asset: fonts/RobotoMono-Bold.ttfweight: 700

pubspec.yaml选项定义

family决定字体的名称&＃xff0c;我们可以在TextStyle对象的fontFamily属性中使用它。

asset是相对于pubspec.yaml文件的字体文件的路径。 这些文件包含字体中字形的轮廓。 在构建我们的应用程序时&＃xff0c;这些文件包含在我们应用程序的asset包中。

单个字体可以引用具有不同轮廓重量和样式的许多不同文件&＃xff1a;

• weight属性指定文件中轮廓线的权重为100到900之间的整数倍。这些值对应于FontWeight&＃xff0c;可用于TextStyle对象的fontWeight属性。
• style属性指定文件中的轮廓是italic还是normal。 这些值对应于FontStyle&＃xff0c;可用于TextStyle对象的fontStyle属性。

3.将字体设置为默认值

对于如何将字体应用于文本&＃xff0c;我们有两种选择&＃xff1a;作为默认字体或仅在特定的小部件中。

要使用字体作为默认字体&＃xff0c;我们可以将fontFamily属性设置为应用theme的一部分。 我们提供给fontFamily的值必须与pubspec.yaml中声明的family相匹配。

new MaterialApp(title: &＃39;Custom Fonts&＃39;,// Set Raleway as the default app fonttheme: new ThemeData(fontFamily: &＃39;Raleway&＃39;),home: new MyHomePage(),
);

有关主题的更多信息&＃xff0c;请查看“使用主题共享颜色和字体样式”配方。

4.在特定的部件中使用字体

如果我们想将字体应用于特定的部件&＃xff0c;比如Text部件&＃xff0c;我们可以向部件提供一个TextStyle。

在这个例子中&＃xff0c;我们将RobotoMono字体应用于单个Text部件。fontFamily再一次必须与我们在pubspec.yaml中声明的family相匹配。

new Text(&＃39;Roboto Mono sample&＃39;,style: new TextStyle(fontFamily: &＃39;RobotoMono&＃39;),
);

TextStyle

如果TextStyle对象指定没有确切字体文件的权重或样式&＃xff0c;则该引擎使用该字体的更通用文件之一&＃xff0c;并尝试针对所请求的权重和样式推断轮廓。

完整的例子

Fonts

Raleway和RobotoMono字体是从谷歌字体下载的。

pubspec.yaml

name: custom_fonts
description: An example of how to use custom fonts with Flutterdependencies:flutter:sdk: flutterdev_dependencies:flutter_test:sdk: flutterflutter:fonts:- family: Ralewayfonts:- asset: fonts/Raleway-Regular.ttf- asset: fonts/Raleway-Italic.ttfstyle: italic- family: RobotoMonofonts:- asset: fonts/RobotoMono-Regular.ttf- asset: fonts/RobotoMono-Bold.ttfweight: 700uses-material-design: true

main.dart

import &＃39;package:flutter/material.dart&＃39;;void main() &＃61;> runApp(new MyApp());class MyApp extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new MaterialApp(title: &＃39;Custom Fonts&＃39;,// Set Raleway as the default app fonttheme: new ThemeData(fontFamily: &＃39;Raleway&＃39;),home: new MyHomePage(),);}
}class MyHomePage extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new Scaffold(// The AppBar will use the app-default Raleway fontappBar: new AppBar(title: new Text(&＃39;Custom Fonts&＃39;)),body: new Center(// This Text Widget will use the RobotoMono font child: new Text(&＃39;Roboto Mono sample&＃39;,style: new TextStyle(fontFamily: &＃39;RobotoMono&＃39;),),),);}
}

从包中导出字体

我们可以将字体声明为单独程序包的一部分&＃xff0c;而不是将字体声明为我们的应用程序的一部分。 这是一种方便的方式&＃xff0c;可以跨几个不同的项目共享相同的字体&＃xff0c;也可以将包发布到 pub website。

路线

• 将字体添加到包中
• 将包和字体添加到我们的应用程序
• 使用字体

1.将字体添加到包中

要从包中导出字体&＃xff0c;我们需要将字体文件导入到我们包项目的lib文件夹中。 我们可以将字体文件直接放在lib文件夹或子目录中&＃xff0c;比如lib/fonts。

在这个例子中&＃xff0c;我们假设我们有一个名为awesome_package的Flutter库&＃xff0c;其中的字体位于lib/fonts文件夹中。

awesome_package/lib/awesome_package.dartfonts/Raleway-Regular.ttfRaleway-Italic.ttf

2.将包和字体添加到我们的应用程序

我们现在可以使用该包并使用它提供的字体。 这涉及到更新应用根目录中的pubspec.yaml。

将该包添加到项目中

dependencies:awesome_package:

声明字体assets

现在我们已经导入了包&＃xff0c;我们需要告诉Flutter从awesome_package中找到哪些字体。

要声明包字体&＃xff0c;我们必须用packages/awesome_package前缀到字体的路径。 这将告诉Flutter查看包的字体的lib文件夹。

flutter:fonts:- family: Ralewayfonts:- asset: packages/awesome_package/fonts/Raleway-Regular.ttf- asset: packages/awesome_package/fonts/Raleway-Italic.ttfstyle: italic

3.使用字体

我们可以使用TextStyle来改变文本的外观。 要使用包字体&＃xff0c;我们不仅需要声明我们想要使用哪种字体&＃xff0c;还需要声明字体所属的package。

new Text(&＃39;Using the Raleway font from the awesome_package&＃39;,style: new TextStyle(fontFamily: &＃39;Raleway&＃39;,package: &＃39;awesome_package&＃39;,),
);

完整的例子

Font
Raleway和RobotoMono字体是从谷歌字体下载的。

pubspec.yaml

name: package_fonts
description: An example of how to use package fonts with Flutterdependencies:awesome_package:flutter:sdk: flutterdev_dependencies:flutter_test:sdk: flutterflutter:fonts:- family: Ralewayfonts:- asset: packages/awesome_package/fonts/Raleway-Regular.ttf- asset: packages/awesome_package/fonts/Raleway-Italic.ttfstyle: italicuses-material-design: true

main.dart

import &＃39;package:flutter/material.dart&＃39;;void main() &＃61;> runApp(new MyApp());class MyApp extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new MaterialApp(title: &＃39;Package Fonts&＃39;,home: new MyHomePage(),);}
}class MyHomePage extends StatelessWidget {&＃64;overrideWidget build(BuildContext context) {return new Scaffold(// The AppBar will use the app-default Raleway fontappBar: new AppBar(title: new Text(&＃39;Package Fonts&＃39;)),body: new Center(// This Text Widget will use the RobotoMono font child: new Text(&＃39;Using the Raleway font from the awesome_package&＃39;,style: new TextStyle(fontFamily: &＃39;Raleway&＃39;,package: &＃39;awesome_package&＃39;,),),),);}
}

添加一个抽屉到屏幕上

在采用Material Design的应用中&＃xff0c;导航有两个主要选项&＃xff1a;选项卡和抽屉。 当没有足够的空间来支持标签时&＃xff0c;抽屉提供了一个方便的选择。

在Flutter中&＃xff0c;我们可以将Drawer小工具与Scaffold结合使用&＃xff0c;以创建带有材质设计Drawer的布局&＃xff01;

路线

 

• 创建一个Scaffold
• 添加一个Drawer
• 用条目填充Drawer
• 以编程方式关闭Drawer

1.创建一个Scaffold

为了将Drawer添加到我们的应用程序中&＃xff0c;我们需要将其包装在Scaffold部件中。 Scaffold部件为遵循Material Design Guidelines的应用程序提供了一致的可视化结构。 它还支持特殊的Material Design组件&＃xff0c;例如Drawers&＃xff0c;AppBars和SnackBars。

在这种情况下&＃xff0c;我们需要创建一个带Drawer的Scaffold&＃xff1a;

new Scaffold(drawer: // We&＃39;ll add our Drawer here in the next step!
);

2.添加一个Drawer

我们现在可以为我们的Scaffold增加一个Drawer。 Drawer可以是任何部件&＃xff0c;但通常最好使用材质库中的Drawer部件&＃xff0c;该材质库遵守材质设计规范。

new Scaffold(drawer: new Drawer(child: // We&＃39;ll populate the Drawer in the next step!)
);

3.用条目填充Drawer

现在我们有了一个Drawer&＃xff0c;我们可以添加内容&＃xff01; 在这个例子中&＃xff0c;我们将使用一个ListView。 尽管我们可以使用Column部件&＃xff0c;但ListView在这种情况下很方便&＃xff0c;因为如果内容占用的空间比屏幕支持的更多&＃xff0c;它将允许用户滚动抽屉。

我们将用一个DrawerHeader和两个ListTile部件填充ListView。 有关使用列表的更多信息&＃xff0c;请参阅列表配方。

new Drawer(// Add a ListView to the drawer. This ensures the user can scroll// through the options in the Drawer if there isn&＃39;t enough vertical// space to fit everything.child: new ListView(// Important: Remove any padding from the ListView.padding: EdgeInsets.zero,children: [new DrawerHeader(child: new Text(&＃39;Drawer Header&＃39;),decoration: new BoxDecoration(color: Colors.blue,),),new ListTile(title: new Text(&＃39;Item 1&＃39;),onTap: () {// Update the state of the app// ...},),new ListTile(title: new Text(&＃39;Item 2&＃39;),onTap: () {// Update the state of the app// ...},),],),
);

4.以编程方式关闭Drawer

用户点击物品后&＃xff0c;我们经常想要关闭抽屉。 我们怎样才能做到这一点&＃xff1f; 使用Navigator&＃xff01;

当用户打开抽屉时&＃xff0c;Flutter会将抽屉添加到引擎盖下的导航堆栈中。 因此&＃xff0c;要关闭抽屉&＃xff0c;我们可以调用Navigator.pop(context)。

new ListTile(title: new Text(&＃39;Item 1&＃39;),onTap: () {// Update the state of the app// ...// Then close the drawer Navigator.pop(context);},
),

完整的例子

import &＃39;package:flutter/material.dart&＃39;;void main() &＃61;> runApp(new MyApp());class MyApp extends StatelessWidget {final appTitle &＃61; &＃39;Drawer Demo&＃39;;&＃64;overrideWidget build(BuildContext context) {return new MaterialApp(title: appTitle,home: new MyHomePage(title: appTitle),);}
}class MyHomePage extends StatelessWidget {final String title;MyHomePage({Key key, this.title}) : super(key: key);&＃64;overrideWidget build(BuildContext context) {return new Scaffold(appBar: new AppBar(title: new Text(title)),body: new Center(child: new Text(&＃39;My Page!&＃39;)),drawer: new Drawer(// Add a ListView to the drawer. This ensures the user can scroll// through the options in the Drawer if there isn&＃39;t enough vertical// space to fit everything.child: new ListView(// Important: Remove any padding from the ListView.padding: EdgeInsets.zero,children: [new DrawerHeader(child: new Text(&＃39;Drawer Header&＃39;),decoration: new BoxDecoration(color: Colors.blue,),),new ListTile(title: new Text(&＃39;Item 1&＃39;),onTap: () {// Update the state of the app// ...// Then close the drawerNavigator.pop(context);},),new ListTile(title: new Text(&＃39;Item 2&＃39;),onTap: () {// Update the state of the app// ...// Then close the drawerNavigator.pop(context);},),],),),);}
}