沉浸式状态栏处理的相关问题

已于 2025-03-24 10:40:36 修改
阅读量6.2k 收藏 10
点赞数 4
分类专栏： Android 文章标签： java android
于 2021-11-29 16:06:30 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Mr_Tony/article/details/121612215
版权

文章目录

一、防止布局被刘海屏遮挡的处理方式

现在手机上会有很多种刘海屏、水滴屏等状态。有时候不做处理的话布局会被刘海屏遮挡。这里需要用到android:fitsSystemWindows="true"属性。如果无效的话，尝试把布局设置为透明即可。

二、改变Android状态栏的颜色

 @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    public static void setStatusBarColor(int statusColor, Activity activity) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            Window window = activity.getWindow();
            //取消设置Window半透明的Flag
            window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
            //添加Flag把状态栏设为可绘制模式
            window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
            //设置状态栏为透明
            window.setStatusBarColor(Color.TRANSPARENT);
            //如果想要修改标题栏文字可以在这里进行修改
            // setAndroidNativeLightStatusBar(activity, true);//字体修改为深色
        }
    }
  public static void setAndroidNativeLightStatusBar(@NonNull Activity activity, boolean dark) {
        try {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                View decor = activity.getWindow().getDecorView();
                if (dark) {
                    decor.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
                } else {
                    decor.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);
                }
            }
        } catch (Exception ignore) {

        }
    }

三、fitsSystemWindows与布局的关系

这里的代码解释有问题，暂时删除，具体可以直接使用上述代码或者<style>的方式实现沉浸式。在郭霖的帖子里面写的只需要更改状态栏颜色为透明的话会出现一些其他问题，比较好的方式是，也添加这行代码activity.getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);。该代码加上状态栏透明的代码效果和下文的<style>中设置沉浸式效果一样。具体差异未深究
这里有两种情况;

  1. 假设容器布局也只是传统的布局LinearLayout布局
    如果什么都不做的话。只是使用fitsSystemWindows属性并不会使布局延伸到状态栏上，这里需要配合上面的代码进行处理。但是并不是所有的组件都可以使用fitsSystemWindows来进行修饰。例如View，而非ViewGroup。例如在TextView、ImageView上面使用就不会有效果。但是在ViewGroup上面使用就会有效果。
  2. 假设容器布局是CoordinatorLayout、CollapsingToolbarLayout、DrawerLayout这些会有一些另外的情况，这时候不需要使用上面的java代码也能实现沉浸式处理，参考以下链接，
    https://guolin.blog.csdn.net/article/details/123023395。
    另外需要注意的是如果要开启沉浸式状态栏，还要设置style样式，代码设置则不用如此如下:
       <style name="Theme.DesignTest" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
	...
    <!-- Customize your theme here. -->
    <item name="android:windowTranslucentStatus">true</item><!--设置沉浸式状态栏-->
</style>
  3. 假如想给状态栏架上遮罩层的话，可以使用<FrameLayout>、<LinearLayout>的不会延伸的特性，例如下文的示例代码，该代码并不需要显示声明高度

四、一个常见的例子

结合上述代码，这里实现一种常见的效果
在这里插入图片描述

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/root_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:background="#F4F5F7">
    <ImageView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="@drawable/js_bg_result_header"
        app:layout_constraintTop_toTopOf="parent"/>
    <FrameLayout
        android:id="@+id/fl_status"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="@color/sq_black_alpha_30"
        android:fitsSystemWindows="true"
        app:layout_constraintTop_toTopOf="parent"
        tools:layout_height="25dp" />

    <TextView
        android:id="@+id/tv_back"
        style="@style/Sqmedium_18_black"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:drawablePadding="@dimen/sq_dp_8"
        android:fitsSystemWindows="true"
        android:gravity="center_vertical"
        android:minHeight="@dimen/sq_dp_44"
        android:paddingStart="@dimen/sq_dp_12"
        android:text="@string/sq_feed_back"
        android:textColor="@color/sq_black_alpha_80"
        android:textSize="@dimen/sq_sp_16"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/fl_status"
        tools:ignore="RtlSymmetry" />
</androidx.constraintlayout.widget.ConstraintLayout>

  @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        setupWindow(this);
        super.onCreate(savedInstanceState);
    }
        private void setupWindow(Activity activity) {
        if (activity != null && activity.getWindow() != null) {
            activity.getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                activity.getWindow().setStatusBarColor(Color.TRANSPARENT);
            }
        }
    }

五、setDecorFitsSystemWindows

该函数用于表示内容是否超出状态栏和底部操作栏，false为超过

WindowCompat.setDecorFitsSystemWindows(window, false)

六、enableEdgeToEdge()

使用enableEdgeToEdge()也可以做到沉浸式，源自依赖
import androidx.activity.enableEdgeToEdge。

androidx.activity:activity:1.8.1@aar

如果不能升级的话使用google的com.google.android.material也是可以的
EdgeToEdgeUtils.applyEdgeToEdge()

七、Fragment

正常来说Fragment也可以使用上述方案实现沉浸式，倘若布局无法出现，可以尝试以下方案
需要注意的是该方案在Fragment中无法使用FrameLayout的特性，可以自己设置高度，或者使用第三方库

八、DialogFragment

如果是对话框的话，那么需要在样式里面去修改，毕竟Dialog和Activity不是一个window。

 <style name="base_dialog_style" parent="android:Theme.Dialog">
        ....
        <item name="android:windowTranslucentStatus">true</item><!--设置沉浸式状态栏-->
    </style>

九、Compose

Android Jetpack Compose 沉浸式状态栏的实现
如果不使用上述链接的解决方式的话，可以使用第六条的解决方案applyEdgeToEdge()。但是该情况下，内容会延伸到状态栏下面，如果需要做到背景延伸，但是内容在状态栏下面，可以使用Modifider..systemBarsPadding()进行高度填充。
可使用方式具体可参考accompanist，这里面不止提供了accompanist的代码还提供了在androidX中可以使用哪些代码

十、获取状态栏和导航栏高度

以下代码可以适配各个版本

    private fun initNavigationBar() {
        ViewCompat.setOnApplyWindowInsetsListener(binding.root) { v, windowInsets ->
            val insets = windowInsets.getInsets(WindowInsetsCompat.Type.navigationBars())//只能获取单个底部导航栏，都获取的话可以用WindowInsetsCompat.Type.systemBars()
            viewModel.updateNavigationHeight(insets.bottom)
//            WindowInsetsCompat.CONSUMED //使用这个后自动修改状态栏和导航栏样式
            windowInsets //使用这个后不会修改状态栏和导航栏样式，有利于精细控制某一部分
        }
    }

十一、android:fitsSystemWindows="true"与EditText控件的关系

在 Android 中，当页面包含 EditText 控件，并且根布局设置了 android:fitsSystemWindows=“true” 属性时，如果输入框获取焦点，可能会导致整个布局下移。这是因为 fitsSystemWindows 属性与软键盘的显示行为产生了冲突。

1. 问题原因

android:fitsSystemWindows="true"：

该属性用于调整布局以适应系统窗口（如状态栏、导航栏）。

当设置为 true 时，布局会为系统窗口留出空间。

软键盘弹出：

当 EditText 获取焦点时，软键盘会自动弹出。

默认情况下，Android 会调整布局以避免软键盘遮挡输入框。

冲突：

fitsSystemWindows 和软键盘的自动调整行为可能会导致布局下移。

2. 解决方案

以下是几种解决布局下移问题的方法：

方法 1：禁用软键盘的布局调整

在 AndroidManifest.xml 中，为对应的 Activity 设置 windowSoftInputMode 属性，禁用软键盘的布局调整。

<activity
    android:name=".YourActivity"
    android:windowSoftInputMode="adjustPan|stateHidden">
</activity>

adjustPan：当软键盘弹出时，将布局向上平移，而不是调整布局大小。

stateHidden：默认隐藏软键盘。

方法 2：动态调整布局

在代码中动态调整布局，避免软键盘弹出时布局下移。


View rootView = findViewById(android.R.id.content);
rootView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        Rect rect = new Rect();
        rootView.getWindowVisibleDisplayFrame(rect);
        int screenHeight = rootView.getRootView().getHeight();
        int keyboardHeight = screenHeight - rect.bottom;

        if (keyboardHeight > screenHeight * 0.15) {
            // 软键盘弹出，调整布局
            rootView.setPadding(0, 0, 0, keyboardHeight);
        } else {
            // 软键盘隐藏，恢复布局
            rootView.setPadding(0, 0, 0, 0);
        }
    }
});

方法 3：使用 CoordinatorLayout 和 AppBarLayout

如果布局中使用了 CoordinatorLayout 和 AppBarLayout，可以通过设置 android:fitsSystemWindows=“true” 和 android:windowSoftInputMode=“adjustResize” 来避免布局下移。

<androidx.coordinatorlayout.widget.CoordinatorLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:fitsSystemWindows="true">

        <!-- AppBar 内容 -->

    </com.google.android.material.appbar.AppBarLayout>

    <!-- 页面内容 -->

</androidx.coordinatorlayout.widget.CoordinatorLayout>

在 AndroidManifest.xml 中设置：

<activity
    android:name=".YourActivity"
    android:windowSoftInputMode="adjustResize">
</activity>

方法 4：自定义 EditText 的焦点行为

通过监听 EditText 的焦点变化，手动调整布局。

EditText editText = findViewById(R.id.editText);
editText.setOnFocusChangeListener(new View.OnFocusChangeListener() {
    @Override
    public void onFocusChange(View v, boolean hasFocus) {
        if (hasFocus) {
            // 获取焦点时，调整布局
            rootView.setPadding(0, 0, 0, keyboardHeight);
        } else {
            // 失去焦点时，恢复布局
            rootView.setPadding(0, 0, 0, 0);
        }
    }
});

十二、参考链接

  1. 沉浸式兼容库:
    更新较新:https://github.com/gyf-dev/ImmersionBar
    长时间未更新:https://github.com/laobie/statusbarutil
  2. WindowInsetsControllerCompat使用，新方式实现状态栏、导航栏、键盘控制
  3. Android开发 WindowInsetsController 窗口控制器
  4. Android 沉浸式状态栏和全面屏遇到刘海屏
  5. Android Detail:Window 篇——WindowInsets 与 fitsSystemBar
  6. Android开发 WindowInsetsController 窗口控制器
  7. 再学一遍android:fitsSystemWindows属性
  8. ANDROID沉浸式状态栏、FITSSYSTEMWINDOWS、标题栏折叠
  9. systemuicontroller(Compose版的状态栏控制)
  10. 在应用中全屏显示内容
  11. android 软键盘动画
  12. Android软键盘遮挡/动画最佳解决方案
  13. 在窗口边衬区内布置应用
沉浸式状态栏在fragment中的使用
05-17
现在我们借助一些flag或者一些第三方的库比如SystemBarTintManager，但是如果Activity有嵌套的fragment,每个fragment的沉浸式要求不同有的要求状态栏标题栏一致，有的要求全屏 有的要求颜色渐变 这种我们需要设置activity全屏 然后自定义一个状态栏
Android 沉浸式状态栏(亲测好用)
01-28
在Android开发中，沉浸式状态栏（Immersive Status Bar）是一种常见的设计手法，它能够使应用的内容无缝地延伸到状态栏下方，提供更全面、更沉浸的用户体验。这种技术尤其在游戏和全屏应用中非常受欢迎，因为它最大...
android 沉浸式的简单处理
jiyidehao的博客
07-31 378
沉浸式分为两类： 1.在根布局使用属性android:fitsSystemWindows="true"（布局不会沉到状态栏中）     这种情况需要给根布局设置背景图 2.在根布局不使用属性android:fitsSystemWindows="true"（布局会沉到状态栏中）     这种情况不需要给根布局设置背景图。     这两种1.2情况只需这样做就行了。     在onCreate...
Android 15新特性，强制edge-to-edge全面屏体验
热门推荐
郭霖的专栏
08-27 2万+
那么由于我们不希望聊天内容进入状态栏区域，因此这里调用了WindowInsetsCompat.Type.statusBars()来获取状态栏的Insets，比如说这里获取到状态栏的高度是50，那么我们通过对chatRecyclerView设置一个50的padding就可以保证聊天内容不进入状态栏区域了。发现了这个现象之后，可能细心的朋友立马就察觉到了，那如果我手机底部的导航栏模式不是这种手势导航栏，而是传统的Back、Home、Task 3按键导航栏，edge-to-edge全面屏体验会变成什么样呢？
Android Window浮窗UI组件使用JetPack
最新发布
天花板的随笔
03-21 1171
LifeCycleOwner在LifeCycle的设计策略中扮演的是生命周期提供者的角色，一个UI组件想要接入到LifeCycle的一系列规则中，就需要实现LifeCycleOwner，比如我们熟知的ComponentActivity就是实现了LifecycleOwner，并且通过。这里就有一个问题，Activity是接入了LifeCycleOwner的，但是Window浮窗是没有接入的，而LiveData在订阅非全局的观察者时，需要有LifeCycleOwner参与，时候那应该怎么办呢？
Android 沉浸式状态栏
xiangxiongfly
09-18 8866
这事可以借助Palette库识别状态栏区域的颜色，如果是浅色将状态栏图标的颜色改为黑色，否则改为白色。将FrameLayout替换为CoordinatorLayout布局。属性不生效，而使用CoordinatorLayout 布局时才能生效。当状态栏图标的颜色和背景图颜色非常接近时，会导致部分内容看不清的情况。可以使用CollapsingToolbarLayout控件解决。状态栏部分没有被颜色，说明沉浸式效果没有达到。为什么根布局是FrameLayout时，图片并有延伸到状态栏区域。...
Snackbar 制作Toast遇到遮挡处理
star_nwe的博客
01-31 985
如果你的应用程序在前台，可以考虑使用Snackbar而不是Toast。Snackbar包括用户可操作的选项，可以提供更好的应用程序体验。
安卓 SystemUiVisibility 被废弃？新的沉浸式写法！
Kingchow的博客
10-17 1万+
最近升级到 API (30) 后发现原本的控制状态栏和导航栏全屏的方法被废弃了。 跳转到源码中查看 setSystemUiVisibility 方法上面的注释，最后的 @deprecated 说明： 从意思上不难看出，官方推荐使用 WindowInsetsController 代替 SystemUiVisibility。 跳转到 WindowInsetsController，其实是一个 interface 接口： 整个 WindowInsetsController 源码内容不多，大家..
android:fitsSystemWindows=“true“导致沉浸式状态栏不起作用
我的专栏
11-30 3093
import android.annotation.SuppressLint import android.annotation.TargetApi import android.app.Activity import android.content.Context import android.graphics.Color import android.os.Build import android.view.View import android.view.WindowManager import...
Android沉浸式状态栏实现示例
08-31
总的来说，实现Android沉浸式状态栏涉及多个步骤，包括设置透明状态栏、处理导航栏颜色、以及调整布局以适应系统窗口。开发者需要根据目标设备的Android版本选择合适的实现方法，以保证兼容性和视觉效果。通过上述...
一个Activity中多个Fragment实现沉浸式状态栏的解决方法
08-31
总结来说，处理一个Activity中的多个Fragment实现沉浸式状态栏，关键在于理解 `android:fitsSystemWindows` 的作用，并在不同生命周期方法中适当地设置状态栏样式。同时，考虑到不同设备的系统栏和虚拟按键可能带来...
利用fragmentation实现多Activity和多Fragment实现,并完美解决沉浸式状态栏
09-28
利用fragmentation实现多Activity和多Fragment实现,并完美解决沉浸式状态栏
沉浸式状态栏demo.rar
12-29
在Android开发中，沉浸式状态栏（Immersive Status Bar）是一种流行的设计手法，它能够为应用程序提供更统一、无边界的视觉体验。沉浸式状态栏允许应用内容扩展到状态栏区域，通常与全屏模式结合使用，为用户提供...
Android Fragment 实现状态栏透明（沉浸式）
龙衣
12-25 5831
来两张效果图对比一下 第一张图是实现了透明状态栏的效果，第二张图是未实现透明状状态栏。如果还看不出区别，那么请打开手机淘宝和任一手机银行App对比顶部的颜色。 现在好多手机已经是全面屏了，如果我们的应用在顶部还是多出来这么一块黑条，那多不美观啊（APP 主题色是黑色的略过） 那么如何实现？我这里由于项目集成了 statusbarutil所以直接就参考了他例子中的代码来实现了。 Status...
compose之沉浸式(侵入式)状态栏（隐藏状态栏）、设置状态栏背景颜色，和字体颜色
wy313622821的博客
07-16 4049
1、代码加入：WindowCompat.setDecorFitsSystemWindows(window, false)二、设置状态栏背景颜色，和字体颜色。
Android---沉浸式状态栏
2401_85239970的博客
05-24 433
沉浸式状态栏，既可以把颜色实现沉浸，又可以把图片实现沉浸。
【Android实战】沉浸式状态栏实现（上）
s003603u的专栏
07-29 8027
Android在4.4的时候增加了透明状态栏与导航栏的功能，依托于这个新特性，我们可以开始跟随潮流，实现Android的沉浸式状态栏
android 状态栏一体化 fragment,GitHub - weiyimeng/Sofia: Android沉浸式效果的实现，状态栏和导航栏均支持设置颜色、渐变色、图片、透明度、内容入侵和状态栏...
weixin_28339967的博客
05-27 341
SofiaAndroid状态栏与导航栏一体化项目，实现沉浸式效果，状态栏和导航栏均支持设置颜色、渐变色、图片、透明度、内容入侵和状态栏深色字体；兼容竖屏、横屏，当屏幕旋转时会自动适配。Sofia一词源自于希腊语∑οφία，含义为智慧，译为中文应该可以叫做索菲亚，这也是我赋予这个项目的愿望。QQ技术交流群：46505645截图 图一：状态栏和导航栏用图片作为背景。图二：状态栏和导航栏随...
unity沉浸式状态栏
01-31
Unity沉浸式状态栏是指在使用Unity引擎开发应用程序时，可以隐藏或者自定义应用程序的状态栏。在移动设备上，状态栏通常包含手机的信号、电池信息等系统图标。通过实现沉浸式状态栏，开发者可以使应用程序在全屏状态下运行，更好地提供用户体验。 在Unity中，实现沉浸式状态栏可以通过以下步骤进行： 首先，开发者需要在Unity中创建一个全屏的视图，包括一整块可以占满屏幕的画布。 然后，通过调用Unity的API函数，可以隐藏状态栏。在Android平台上，可以使用Application类的方法SetStatusBarHidden()将状态栏隐藏起来，并且设置为全屏状态。在iOS平台上，可以使用Screen类的方法SetStatusBarHidden()来隐藏状态栏。 此外，也可以自定义状态栏的样式，使其与应用程序的设计风格相符。例如，在Android平台上，可以使用Unity提供的插件设置状态栏的颜色、字体颜色等属性。 需要注意的是，沉浸式状态栏功能在不同的平台上具有不同的实现方法和限制。为了确保应用程序的兼容性和稳定性，在使用沉浸式状态栏的时候，开发者需要根据不同的平台和设备进行适配和测试。 综上所述，Unity沉浸式状态栏是通过隐藏或自定义状态栏，在应用程序运行时提供更加全屏的体验。开发者可以通过Unity的API函数实现沉浸式状态栏，并根据需要进行定制，提升应用程序的用户体验。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值