Android - InsetsWidget

一组可以动态适配 WindowInsets 尺寸的组件，用于快速实现沉浸式布局效果。

您可以通过阅读官方文章来了解什么是 在应用中全屏显示内容 。

Usage

Setup

添加依赖：

repositories { 
    maven { setUrl("https://jitpack.io") }
}

dependencies {
    implementation("androidx.core:core-ktx:1.15.0")
    implementation("androidx.activity:activity-ktx:1.10.0")
    implementation("com.github.TakWolf.Android-InsetsWidget:insetswidget:0.0.1")
    // 可选。为 `ConstraintLayout` 添加支持。
    implementation("androidx.constraintlayout:constraintlayout:2.2.0")
    implementation("com.github.TakWolf.Android-InsetsWidget:constraintlayout:0.0.1")
}

在 Activity 中启用「边到边」：

class SomeActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_some)
    }
}

最后，确保不要在你的布局中使用 android:fitsSystemWindows="true" 属性。

该属性会拦截 WindowInsets 事件，从而导致组件失效。

InsetsView

包括：

• InsetsView
• InsetsSpace

这个类型的组件尺寸会自动适配窗口附加物类型的尺寸。例如：

<com.takwolf.android.insetswidget.InsetsView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:isw_insetsType="statusBars" />

InsetsLayout

包括：

• InsetsFrameLayout
• InsetsLinearLayout
• InsetsNestedScrollView
• InsetsConstraintLayout

这个类型的组件，会自动添加 Padding 来适配窗口附加物类型的尺寸。也可以额外配置颜色。例如：

<com.takwolf.android.insetswidget.InsetsLinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    app:isw_insetsType="statusBars|navigationBars"
    app:isw_insetsPaddingBottom="false"
    app:isw_insetsColorTop="@color/translucent_black"
    app:isw_insetsColorBottom="@color/translucent_black">
    
    <YourView />
    
</com.takwolf.android.insetswidget.InsetsLinearLayout>

License

Apache License 2.0