前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >【Flutter 专题】41 图解神秘的 SystemChrome~

【Flutter 专题】41 图解神秘的 SystemChrome~

作者头像
阿策小和尚
发布2019-08-12 16:28:45
1.8K0
发布2019-08-12 16:28:45
举报
文章被收录于专栏:阿策小和尚阿策小和尚

和尚在切换横竖屏时用到 SystemChrome,和尚理解它作为一个全局属性,很像 AndroidApplication,功能很强大。

setPreferredOrientations

在我们日常应用中可能会需要设置横竖屏,或锁定单方向屏幕等不同要求,通过 setPreferredOrientations 配合实现;简单可以按 portraitUp 上 / portraitDown 下 / landscapeLeft 右 / landscapeRight 左 来区分;

Tips:landscapeLeft 是以 portraitUp 顺时针旋转 90 度;landscapeRight 是以逆时针旋转 90 度,故是视觉相反。

1. 单方向

若需要固定应用为单一方向,仅需设置所需要的方向属性即可;

代码语言:javascript
复制
// 竖直上
SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
// 竖直下
SystemChrome.setPreferredOrientations([DeviceOrientation.portraitDown]);
// 水平左
SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft]);
// 水平右
SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeRight]);
2. 多方向

若需要应用随重力感应变化方向,需设置多个方向属性;

代码语言:javascript
复制
// 竖直方向
SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp, DeviceOrientation.portraitDown]);
// 水平方向
SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft, DeviceOrientation.landscapeLeft]);
// 多方向
SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft, DeviceOrientation.landscapeLeft, DeviceOrientation.portraitUp]);

Tips:

  1. portraitDown 属性请注意,多方向时一般不会有效果,系统默认不会颠倒;
  2. 多方向设置时初始方向分两种情况,第一种:当前重力感应方向不在设置多方向列表中,初始方向为列表第一个设置方法;第二种:当前重力感应方向在设置多方向列表中,无论顺序第几位,默认均展示当前重力感应方向(非 portraitDown)。

setEnabledSystemUIOverlays

setEnabledSystemUIOverlays 是指定在应用程序运行时可见的系统叠加,主要对状态栏的操作,读起来比较拗口,但是看测试用例就很明了;参数分 top 顶部 / bottom 底部 两种;

1. SystemUiOverlay.top

默认隐藏底部虚拟状态栏(需手机支持虚拟状态栏设备),即三大金刚键;获取焦点后展示状态栏,展示大小为去掉状态栏时整体大小;

代码语言:javascript
复制
SystemChrome.setEnabledSystemUIOverlays([SystemUiOverlay.top]);
2. SystemUiOverlay.bottom

默认隐藏顶部虚拟状态栏,获取焦点后展示状态栏,展示大小为去掉状态栏时整体大小;

代码语言:javascript
复制
SystemChrome.setEnabledSystemUIOverlays([SystemUiOverlay.bottom]);
3. 两者皆有

即默认情况,顶部底部状态栏均展示;

代码语言:javascript
复制
SystemChrome.setEnabledSystemUIOverlays([SystemUiOverlay.top, SystemUiOverlay.bottom]);

setSystemUIOverlayStyle

setSystemUIOverlayStyle 用来设置状态栏顶部和底部样式,默认有 lightdark 模式,也可以按照需求自定义样式;

1. systemNavigationBarColor

该属性仅用于 Android 设备且 SDK >= O 时,底部状态栏颜色;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(systemNavigationBarColor: Colors.pink));
2. systemNavigationBarDividerColor

该属性仅用于 Android 设备且 SDK >= P 时,底部状态栏与主内容分割线颜色,效果不是很明显;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(systemNavigationBarDividerColor: Colors.yellow));
3. systemNavigationBarIconBrightness

该属性仅用于 Android 设备且 SDK >= O 时,底部状态栏图标样式,主要是三大按键颜色;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(systemNavigationBarColor: Colors.pink));
4. statusBarColor

该属性仅用于 Android 设备且 SDK >= M 时,顶部状态栏颜色;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(statusBarColor: Colors.red));
5. statusBarIconBrightness

该属性仅用于 Android 设备且 SDK >= M 时,顶部状态栏图标的亮度;但和尚感觉并不明显;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(statusBarIconBrightness: Brightness.dark));
6. statusBarBrightness

该属性仅用于 iOS 设备顶部状态栏亮度;

代码语言:javascript
复制
SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle(statusBarBrightness: Brightness.light));

setApplicationSwitcherDescription

和尚个人理解该属性显示效果是在应用程序切换器相关的应用程序的当前状态时,但是和尚反复测试并没有实际效果,希望有理解的大神多多指点;

代码语言:javascript
复制
SystemChrome.setApplicationSwitcherDescription(
        const ApplicationSwitcherDescription(
            label: "Demo Flutter", primaryColor: 0xFFE53935))
    .then((_) {
  runApp(new MyApp());
});

整体来说 Flutter 对顶部底部状态栏的设置很方便,只是有些和尚理解不够深入的地方,有见解对朋友希望多多指导!

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2019-04-15,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 阿策小和尚 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • setPreferredOrientations
    • 1. 单方向
      • 2. 多方向
      • setEnabledSystemUIOverlays
        • 1. SystemUiOverlay.top
          • 2. SystemUiOverlay.bottom
            • 3. 两者皆有
            • setSystemUIOverlayStyle
              • 1. systemNavigationBarColor
                • 2. systemNavigationBarDividerColor
                  • 3. systemNavigationBarIconBrightness
                    • 4. statusBarColor
                      • 5. statusBarIconBrightness
                        • 6. statusBarBrightness
                        • setApplicationSwitcherDescription
                        领券
                        问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档