@emmaus/capacitor-plugin-android-insets

Capacitor plugin for retrieving proper top offset of Android status bar.

This repo is published version with changed name of https://github.com/jorisbertomeu/capacitor-insets-v2, which was based on archived https://github.com/igorcd/capacitor-insets-plugin/. It should work perfectly fine in Capacitor@4.

Install

# with npm
npm install --save @emmaus/capacitor-plugin-android-insets
# with yarn
yarn add @emmaus/capacitor-plugin-android-insets
# after any install
npx cap sync

Why?

This plugin is required only on Android when using StatusBar.setOverlaysWebView({ overlay: true }). There is a problem with top offset counting, when status bar is transparent. Related issue: https://github.com/ionic-team/capacitor/issues/2840.

Usage

import { AndroidInsets } from '@emmaus/capacitor-plugin-android-insets';

const { value } = await AndroidInsets.top();

API

• getDisplayInfo()
• setNavbarBackgroundColor(...)
• Interfaces

getDisplayInfo()

getDisplayInfo() => Promise<GetDisplayInfoReturn>

Returns: Promise<GetDisplayInfoReturn>

setNavbarBackgroundColor(...)

setNavbarBackgroundColor(options: { r: number; g: number; b: number; a: number; }) => Promise<void>

| Param | Type | | ------------- | ------------------------------------------------------------ | | options | { r: number; g: number; b: number; a: number; } |

Interfaces

GetDisplayInfoReturn

| Prop | Type | | --------------------- | ----------------------------------------------------------------------------- | | isGestureMode | boolean | | rotation | 'portrait' | 'landscape-left' | 'landscape-right' | 'unknown' | | statusbarHeight | number | | navbarPosition | 'BOTTOM' | 'RIGHT' | 'LEFT' | 'UNKNOWN' | | navbarSize | number | | insetTop | number | | insetRight | number | | insetBottom | number | | insetLeft | number |