gyf-dev/ImmersionBar
ImmersionBar
ImmersionBar is a set of control utilities for Android designed to manage immersive display modes, notch-aware layouts, virtual keyboard visibility, and system bar aesthetics. It provides a centralized way to maximize screen real estate by toggling full-screen displays and controlling the behavior of status and navigation bars.
The library distinguishes itself through specialized adaptation for hardware cutouts and notches, calculating precise offsets and window insets to prevent user interface elements from being obscured. It also includes a dedicated handler for soft keyboard management, which resolves conflicts between the virtual keyboard and bottom input fields to ensure active elements remain visible.
The project covers a broad range of UI optimization capabilities, including system bar styling for colors and transparency, icon contrast adjustments based on background luminance, and lifecycle-aware state coordination across activities, fragments, and dialogs. It further provides tools for retrieving pixel-precise display metrics and applying dynamic padding or margins to prevent content overlap with system interface elements.
Features
- Immersive Mode System Bars - Maximizes screen real estate by hiding system bars and extending application content to fill the entire display.
- Notch Display Adjustments - Calculates hardware cutout offsets to align critical layout elements and prevent occlusion by the camera notch.
- Keyboard Occlusion Prevention - Adjusts the view frame automatically when the keyboard appears to ensure text input fields remain visible.
- Window Flag Modifications - Toggles system bar visibility and full-screen behavior by modifying Android window flags and layout parameters at runtime.
- Soft Keyboard Layout Managers - Handles layout shifts and view repositioning when the virtual keyboard appears to keep active input fields visible.
- Soft Keyboard Window Managers - Manages window soft-input modes to prevent interface overlap when the Android virtual keyboard is displayed.
- Soft Input Mode Controllers - Modifies window soft-input configurations to prevent interface overlap when the virtual keyboard is displayed.
- Display Cutout Managers - Provides utilities for identifying safe screen areas to prevent UI content from being obscured by camera notches and cutouts.
- System Bar Occlusion Avoidance - Applies padding and margins to stop system bars from obscuring critical application content and interactive elements.
- Lifecycle-Aware Immersive Coordination - Coordinates immersive mode settings across screen components to ensure consistent styling during transitions.
- Detection Utilities - Detects the presence of notch screens and retrieves their height to facilitate layout adjustments for cutouts.
- Dimension Retrievals - Provides precise dimension retrieval for status bars, navigation bars, and notch areas to identify hardware display features.
- Dimension Retrievals - Retrieves pixel-precise dimensions of status bars, navigation bars, and screen notches to ensure accurate interface positioning.
- System Bar Visual Styling - Customizes the colors, transparency, and visibility of status and navigation bars across different screen types.
- System Bar Overlap Preventions - Prevents content from overlapping with the status bar using padding, margins, or dedicated placeholder views.
- System Bar Padding Utilities - Applies dynamic margins and padding to layout elements to ensure content does not overlap with system bars.
- System Bar Controls - Controls the visibility, colors, and layout of Android status and navigation bars across different activities and fragments.
- Edge-to-Edge Layouts - Extends the layout to occupy the entire screen by covering the area behind system navigation and status bars.
- Inset Calculators - Determines system bar and hardware notch dimensions by querying window insets to apply precise layout offsets.
- Keyboard Management - Uses listeners to detect virtual keyboard visibility changes to resolve layout conflicts with input fields.
- Android Keyboard Event Tracking - Monitors soft keyboard events to adjust layouts and prevent input fields from being obscured.
- System-Aware Layout Optimizations - Applies precise padding and margins to ensure app content does not overlap with the system status or navigation bars.
- System Bar Layout Helpers - Applies precise padding and margins to ensure Android app content does not overlap with system bars.
- System Bar Compatibility Layers - Provides a compatibility layer to manage system bar behavior across various Android versions and screen orientations.
- Android System Bar Stylers - Adjusts the colors and appearance of status and navigation bars to match an app's visual theme.
- Cross-Component Bar Styling - Sets colors and transparency for status and navigation bars across activities, fragments, and dialogs.
- Color Themes - Updates system bar colors and icon styles based on the application's visual theme and window attributes.
- Semantic Color Mappings - Updates status and navigation bar icon colors using theme resource mapping for visual contrast.
- System Bar Style Coordinators - Synchronizes system bar styling across activities and fragments to ensure visual consistency during screen transitions.
- Multi-Container Immersive Support - Applies immersive settings across activities, fragments, dialogs, and popup windows.
- Fragment-Based Bar Orchestration - Manages status and navigation bar styles during fragment lifecycle events and pager transitions.
- Luminance-Based Contrast Adjustments - Adjusts status bar fonts and navigation icons to ensure high contrast based on the background color.
- Icon Contrast Controllers - Toggles the color of status bar fonts and navigation icons based on background luminance to ensure legibility.
- System Bars - Immersive status bar implementation.
