根据屏幕方向更新用户界面
在某些情况下,您希望在可用空间形状发生变化时更新应用的显示,例如当用户将屏幕从纵向模式旋转到横向模式时。例如,应用可能在纵向模式下逐个显示项目,而在横向模式下并排显示这些相同的项目。有关此内容及更多内容的扩展文档,请参阅 自适应 UI 文档。
在 Flutter 中,您可以根据给定的 Orientation
构建不同的布局。在此示例中,使用以下步骤构建一个在纵向模式下显示两列,在横向模式下显示三列的列表:
- 构建一个具有两列的
GridView
。 - 使用
OrientationBuilder
更改列数。
1. 构建一个具有两列的 GridView
#首先,创建一个要处理的项目列表。而不是使用普通列表,创建一个显示网格中项目的列表。目前,创建一个具有两列的网格。
return GridView.count(
// A list with 2 columns
crossAxisCount: 2,
// ...
);
要了解有关使用 GridViews
的更多信息,请参阅 创建网格列表 食谱。
2. 使用 OrientationBuilder
更改列数
#要确定应用的当前 Orientation
,请使用 OrientationBuilder
小部件。OrientationBuilder
通过比较父小部件可用的宽度和高度来计算当前 Orientation
,并在父小部件的大小改变时进行重建。
使用 Orientation
,构建一个在纵向模式下显示两列,在横向模式下显示三列的列表。
body: OrientationBuilder(
builder: (context, orientation) {
return GridView.count(
// Create a grid with 2 columns in portrait mode,
// or 3 columns in landscape mode.
crossAxisCount: orientation == Orientation.portrait ? 2 : 3,
);
},
),
互动示例
#import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
const appTitle = 'Orientation Demo';
return const MaterialApp(
title: appTitle,
home: OrientationList(title: appTitle),
);
}
}
class OrientationList extends StatelessWidget {
final String title;
const OrientationList({super.key, required this.title});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text(title)),
body: OrientationBuilder(
builder: (context, orientation) {
return GridView.count(
// Create a grid with 2 columns in portrait mode, or
// 3 columns in landscape mode.
crossAxisCount: orientation == Orientation.portrait ? 2 : 3,
// Generate 100 widgets that display their index in the list.
children: List.generate(100, (index) {
return Center(
child: Text(
'Item $index',
style: TextTheme.of(context).displayLarge,
),
);
}),
);
},
),
);
}
}
锁定设备方向
#在上一节中,您学习了如何使应用 UI 适应设备方向更改。
Flutter 还允许您使用 DeviceOrientation
的值来指定应用支持的方向。您可以选择
- 将应用锁定为单个方向,例如仅
portraitUp
位置,或者... - 允许多种方向,例如
portraitUp
和portraitDown
,但不允许横向。
在应用的 main()
方法中,使用您的应用支持的首选方向列表调用 SystemChrome.setPreferredOrientations()
。
要将设备锁定为单个方向,您可以传递一个包含单个项目的列表。
有关所有可能值的列表,请查看 DeviceOrientation
。
void main() {
WidgetsFlutterBinding.ensureInitialized();
SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
runApp(const MyApp());
}